€cdocutils.nodes document q)q}q(U nametypesq}q(X%configuring builds with cabal.projectqNX)how can i profile my library/application?qNX quickstartqNXhaddock optionsq NXcmdoption-project-fileq ˆXcmdoption--store-dirq ˆXcabal new-replq NXstatic linking optionsq NXcabal new-updateqNXsolver configuration optionsqNXhoogleqˆXhscolourqˆXcabal new-haddockqNXabnfqˆXcabal new-installqNXcmdoption--project-fileqˆXhackageqˆXexecutable optionsqNXspecifying the local packagesqNXcabal new-configureqNXcabal new-benchqNXhappyqˆXcabal new-freezeqNXhaskellqˆXcmdoption--builddirqˆXobject code optionsqNX%advanced global configuration optionsq NX how it worksq!NXpvpq"ˆX"foreign function interface optionsq#NXdynamic linking optionsq$NXadvanced solver optionsq%NXdeveloping multiple packagesq&NXcoverage optionsq'NXcommandsq(NXthis section of the ghc manualq)ˆXalexq*ˆXcabal new-execq+NXcabal new-sdistq,NXglobal configuration optionsq-NXcpphsq.ˆXwhere are my build products?q/NXhaddockq0ˆX cabal new-runq1NXlocal versus external packagesq2NXcabal new-cleanq3NXpackage configuration optionsq4NXcabal new-buildq5NXcachingq6NXcabal new-testq7NXcookbookq8NXpackage versioning policyq9ˆXprofiling optionsq:NuUsubstitution_defsq;}q(cdocutils.nodes system_message q?)q@}qA(U rawsourceqBUUparentqCcdocutils.nodes section qD)qE}qF(hBUhChD)qG}qH(hBUhChUsourceqIXA/home/refold/code/haskell/cabal-2.4/Cabal/doc/nix-local-build.rstqJUtagnameqKUsectionqLU attributesqM}qN(UdupnamesqO]UclassesqP]UbackrefsqQ]UidsqR]qSU how-it-worksqTaUnamesqU]qVh!auUlineqWKjUdocumentqXhUchildrenqY]qZ(cdocutils.nodes title q[)q\}q](hBX How it worksq^hChGhIhJhKUtitleq_hM}q`(hO]hP]hQ]hR]hU]uhWKjhXhhY]qacdocutils.nodes Text qbX How it worksqc…qd}qe(hBh^hINhWNhXhhCh\ubaubhEhD)qf}qg(hBUhChGhIhJhKhLhM}qh(hO]hP]hQ]hR]qiUwhere-are-my-build-productsqjahU]qkh/auhWK¤hXhhY]ql(h[)qm}qn(hBXWhere are my build products?qohChfhIhJhKh_hM}qp(hO]hP]hQ]hR]hU]uhWK¤hXhhY]qqhbXWhere are my build products?qr…qs}qt(hBhohINhWNhXhhChmubaubcdocutils.nodes paragraph qu)qv}qw(hBXtA major deficiency in the current implementation of new-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 new-build, but we also understand that many unimplemented features can only be reasonably worked around by accessing build products directly.qxhChfhIhJhKU paragraphqyhM}qz(hO]hP]hQ]hR]hU]uhWK¦hXhhY]q{hbXtA major deficiency in the current implementation of new-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 new-build, but we also understand that many unimplemented features can only be reasonably worked around by accessing build products directly.q|…q}}q~(hBhxhINhWNhXhhChvubaubhu)q}q€(hBX`The location where build products can be found varies depending on the version of cabal-install:qhChfhIhJhKhyhM}q‚(hO]hP]hQ]hR]hU]uhWK­hXhhY]qƒhbX`The location where build products can be found varies depending on the version of cabal-install:q„…q…}q†(hBhhINhWNhXhhChubaubcdocutils.nodes bullet_list q‡)qˆ}q‰(hBUhChfhIhJhKU bullet_listqŠhM}q‹(UbulletqŒX-hR]hQ]hO]hP]hU]uhWK°hXhhY]q(cdocutils.nodes list_item qŽ)q}q(hBXś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``. hChˆhIhJhKU list_itemq‘hM}q’(hO]hP]hQ]hR]hU]uhWNhXhhY]q“hu)q”}q•(hBXł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``.hChhIhJhKhyhM}q–(hO]hP]hQ]hR]hU]uhWK°hY]q—(hbX8In cabal-install-1.24, the dist directory for a package q˜…q™}qš(hBX8In cabal-install-1.24, the dist directory for a package hCh”ubcdocutils.nodes literal q›)qœ}q(hBX ``p-0.1``hM}qž(hO]hP]hQ]hR]hU]uhCh”hY]qŸhbXp-0.1q …q”}q¢(hBUhChœubahKUliteralq£ubhbX is stored in q¤…q„}q¦(hBX is stored in hCh”ubh›)q§}qØ(hBX``dist-newstyle/build/p-0.1``hM}q©(hO]hP]hQ]hR]hU]uhCh”hY]qŖhbXdist-newstyle/build/p-0.1q«…q¬}q­(hBUhCh§ubahKh£ubhbX>. For example, if you built an executable or test suite named q®…qÆ}q°(hBX>. For example, if you built an executable or test suite named hCh”ubh›)q±}q²(hBX``pexe``hM}q³(hO]hP]hQ]hR]hU]uhCh”hY]q“hbXpexeqµ…q¶}q·(hBUhCh±ubahKh£ubhbX, it would be located at qø…q¹}qŗ(hBX, it would be located at hCh”ubh›)q»}q¼(hBX-``dist-newstyle/build/p-0.1/build/pexe/pexe``hM}q½(hO]hP]hQ]hR]hU]uhCh”hY]q¾hbX)dist-newstyle/build/p-0.1/build/pexe/pexeq慁qĄ}qĮ(hBUhCh»ubahKh£ubhbX.…qĀ}qĆ(hBX.hCh”ubeubaubhŽ)qÄ}qÅ(hBX>In cabal-install-2.0 and above, 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!) hChˆhIhJhKh‘hM}qĘ(hO]hP]hQ]hR]hU]uhWNhXhhY]qĒhu)qČ}qÉ(hBX=In cabal-install-2.0 and above, 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!)hChÄhIhJhKhyhM}qŹ(hO]hP]hQ]hR]hU]uhWKµhY]qĖ(hbXAIn cabal-install-2.0 and above, the dist directory for a package qĢ…qĶ}qĪ(hBXAIn cabal-install-2.0 and above, the dist directory for a package hChČubh›)qĻ}qŠ(hBX ``p-0.1``hM}qŃ(hO]hP]hQ]hR]hU]uhChČhY]qŅhbXp-0.1qӅqŌ}qÕ(hBUhChĻubahKh£ubhbX< defining a library built with GHC 8.0.1 on 64-bit Linux is qօq×}qŲ(hBX< defining a library built with GHC 8.0.1 on 64-bit Linux is hChČubh›)qŁ}qŚ(hBX4``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1``hM}qŪ(hO]hP]hQ]hR]hU]uhChČhY]qÜhbX0dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1qŻ…qŽ}qß(hBUhChŁubahKh£ubhbXx. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named qą…qį}qā(hBXx. When per-component builds are enabled (any non-Custom package), a subcomponent like an executable or test suite named hChČubh›)qć}qä(hBX``pexe``hM}qå(hO]hP]hQ]hR]hU]uhChČhY]qęhbXpexeqē…qč}qé(hBUhChćubahKh£ubhbX will be stored at qź…qė}qģ(hBX will be stored at hChČubh›)qķ}qī(hBX;``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe``hM}qļ(hO]hP]hQ]hR]hU]uhChČhY]qšhbX7dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexeqń…qņ}qó(hBUhChķubahKh£ubhbX+; thus, the full path of the executable is qō…qõ}qö(hBX+; thus, the full path of the executable is hChČubh›)q÷}qų(hBXK``dist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexe``hM}qł(hO]hP]hQ]hR]hU]uhChČhY]qśhbXGdist-newstyle/build/x86_64-linux/ghc-8.0.1/p-0.1/c/pexe/build/pexe/pexeqū…qü}qż(hBUhCh÷ubahKh£ubhbX? (you can see why we want this to be an implementation detail!)qž…q’}r(hBX? (you can see why we want this to be an implementation detail!)hChČubeubaubeubhu)r}r(hBX6The 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.rhChfhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWKĄhXhhY]rhbX6The 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(hBjhINhWNhXhhCjubaubeubhD)r }r (hBUhChGhIhJhKhLhM}r (hO]hP]hQ]hR]r Ucachingr ahU]rh6auhWKĒhXhhY]r(h[)r}r(hBXCachingrhCj hIhJhKh_hM}r(hO]hP]hQ]hR]hU]uhWKĒhXhhY]rhbXCachingr…r}r(hBjhINhWNhXhhCjubaubhu)r}r(hBXŪ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 ``new-build``. The cached intermediate results are stored in ``dist-newstyle/cache``; this folder can be safely deleted to clear the cache.hCj hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWKÉhXhhY]r(hbXŽ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(hBXŽ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 hINhWNhXhhCjubh›)r}r (hBX``cabal-install``hM}r!(hO]hP]hQ]hR]hU]uhCjhY]r"hbX cabal-installr#…r$}r%(hBUhCjubahKh£ubhbX± 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((hBX± 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 hINhWNhXhhCjubh›)r)}r*(hBX ``new-build``hM}r+(hO]hP]hQ]hR]hU]uhCjhY]r,hbX new-buildr-…r.}r/(hBUhCj)ubahKh£ubhbX0. The cached intermediate results are stored in r0…r1}r2(hBX0. The cached intermediate results are stored in hINhWNhXhhCjubh›)r3}r4(hBX``dist-newstyle/cache``hM}r5(hO]hP]hQ]hR]hU]uhCjhY]r6hbXdist-newstyle/cacher7…r8}r9(hBUhCj3ubahKh£ubhbX7; this folder can be safely deleted to clear the cache.r:…r;}r<(hBX7; this folder can be safely deleted to clear the cache.hINhWNhXhhCjubeubhu)r=}r>(hBXwThe following intermediate results are cached in the following files in this folder (the most important two are first):r?hCj hIhJhKhyhM}r@(hO]hP]hQ]hR]hU]uhWKŅhXhhY]rAhbXwThe following intermediate results are cached in the following files in this folder (the most important two are first):rB…rC}rD(hBj?hINhWNhXhhCj=ubaubcdocutils.nodes definition_list rE)rF}rG(hBUhCj hIhJhKUdefinition_listrHhM}rI(hO]hP]hQ]hR]hU]uhWNhXhhY]rJ(cdocutils.nodes definition_list_item rK)rL}rM(hBXz``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.)hCjFhIhJhKUdefinition_list_itemrNhM}rO(hO]hP]hQ]hR]hU]uhWKŚhY]rP(cdocutils.nodes term rQ)rR}rS(hBX``solver-plan`` (binary)rThCjLhIhJhKUtermrUhM}rV(hO]hP]hQ]hR]hU]uhWKŚhY]rW(h›)rX}rY(hBX``solver-plan``hM}rZ(hO]hP]hQ]hR]hU]uhCjRhY]r[hbX solver-planr\…r]}r^(hBUhCjXubahKh£ubhbX (binary)r_…r`}ra(hBX (binary)hCjRubeubcdocutils.nodes definition rb)rc}rd(hBUhM}re(hO]hP]hQ]hR]hU]uhCjLhY]rfhu)rg}rh(hBXaThe 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.)hCjchIhJhKhyhM}ri(hO]hP]hQ]hR]hU]uhWKÖhY]rj(hbXTThe result of calling the dependency solver, assuming that the Hackage index, local rk…rl}rm(hBXTThe result of calling the dependency solver, assuming that the Hackage index, local hCjgubh›)rn}ro(hBX``cabal.project``hM}rp(hO]hP]hQ]hR]hU]uhCjghY]rqhbX cabal.projectrr…rs}rt(hBUhCjnubahKh£ubhbX file, and local ru…rv}rw(hBX file, and local hCjgubh›)rx}ry(hBX ``cabal``hM}rz(hO]hP]hQ]hR]hU]uhCjghY]r{hbXcabalr|…r}}r~(hBUhCjxubahKh£ubhbXā 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(hBXā 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.)hCjgubeubahKU definitionr‚ubeubjK)rƒ}r„(hBXŪ``source-hashes`` (binary) The hashes of all local source files. When all local source files of a local package are unchanged, ``cabal new-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.)hCjFhIhJhKjNhM}r…(hO]hP]hQ]hR]hU]uhWKćhXhhY]r†(jQ)r‡}rˆ(hBX``source-hashes`` (binary)r‰hCjƒhIhJhKjUhM}rŠ(hO]hP]hQ]hR]hU]uhWKćhY]r‹(h›)rŒ}r(hBX``source-hashes``hM}rŽ(hO]hP]hQ]hR]hU]uhCj‡hY]rhbX source-hashesr…r‘}r’(hBUhCjŒubahKh£ubhbX (binary)r“…r”}r•(hBX (binary)hCj‡ubeubjb)r–}r—(hBUhM}r˜(hO]hP]hQ]hR]hU]uhCjƒhY]r™hu)rš}r›(hBXĄThe hashes of all local source files. When all local source files of a local package are unchanged, ``cabal new-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.)hCj–hIhJhKhyhM}rœ(hO]hP]hQ]hR]hU]uhWKŻhY]r(hbXdThe hashes of all local source files. When all local source files of a local package are unchanged, rž…rŸ}r (hBXdThe hashes of all local source files. When all local source files of a local package are unchanged, hCjšubh›)r”}r¢(hBX``cabal new-build``hM}r£(hO]hP]hQ]hR]hU]uhCjšhY]r¤hbXcabal new-buildr„…r¦}r§(hBUhCj”ubahKh£ubhbX will skip invoking rØ…r©}rŖ(hBX will skip invoking hCjšubh›)r«}r¬(hBX``setup build``hM}r­(hO]hP]hQ]hR]hU]uhCjšhY]r®hbX setup buildrÆ…r°}r±(hBUhCj«ubahKh£ubhbX7 entirely (saving us from a possibly expensive call to r²…r³}r“(hBX7 entirely (saving us from a possibly expensive call to hCjšubh›)rµ}r¶(hBX``ghc --make``hM}r·(hO]hP]hQ]hR]hU]uhCjšhY]røhbX ghc --maker¹…rŗ}r»(hBUhCjµubahKh£ubhbXS). The full list of source files participating in compilation are determined using r¼…r½}r¾(hBXS). The full list of source files participating in compilation are determined using hCjšubh›)ræ}rĄ(hBX``setup sdist --list-sources``hM}rĮ(hO]hP]hQ]hR]hU]uhCjšhY]rĀhbXsetup sdist --list-sourcesrĆ…rÄ}rÅ(hBUhCjæubahKh£ubhbXp (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)rĘ…rĒ}rČ(hBXp (thus, if you do not list all your source files in a Cabal file, you may fail to recompile when you edit them.)hCjšubeubahKj‚ubeubjK)rÉ}rŹ(hBX ``config`` (same format as ``cabal.project``) The full project configuration, merged from ``cabal.project`` (and friends) as well as the command line arguments.hCjFhIhJhKjNhM}rĖ(hO]hP]hQ]hR]hU]uhWKęhXhhY]rĢ(jQ)rĶ}rĪ(hBX-``config`` (same format as ``cabal.project``)rĻhCjÉhIhJhKjUhM}rŠ(hO]hP]hQ]hR]hU]uhWKęhY]rŃ(h›)rŅ}rÓ(hBX ``config``hM}rŌ(hO]hP]hQ]hR]hU]uhCjĶhY]rÕhbXconfigrÖ…r×}rŲ(hBUhCjŅubahKh£ubhbX (same format as rŁ…rŚ}rŪ(hBX (same format as hCjĶubh›)rÜ}rŻ(hBX``cabal.project``hM}rŽ(hO]hP]hQ]hR]hU]uhCjĶhY]rßhbX cabal.projectrą…rį}rā(hBUhCjÜubahKh£ubhbX)…rć}rä(hBX)hCjĶubeubjb)rå}rę(hBUhM}rē(hO]hP]hQ]hR]hU]uhCjÉhY]rčhu)ré}rź(hBXrThe full project configuration, merged from ``cabal.project`` (and friends) as well as the command line arguments.hCjåhIhJhKhyhM}rė(hO]hP]hQ]hR]hU]uhWKęhY]rģ(hbX,The full project configuration, merged from rķ…rī}rļ(hBX,The full project configuration, merged from hCjéubh›)rš}rń(hBX``cabal.project``hM}rņ(hO]hP]hQ]hR]hU]uhCjéhY]róhbX cabal.projectrō…rõ}rö(hBUhCjšubahKh£ubhbX5 (and friends) as well as the command line arguments.r÷…rų}rł(hBX5 (and friends) as well as the command line arguments.hCjéubeubahKj‚ubeubjK)rś}rū(hBXX``compiler`` (binary) The configuration of the compiler being used to build the project.hCjFhIhJhKjNhM}rü(hO]hP]hQ]hR]hU]uhWKčhXhhY]rż(jQ)rž}r’(hBX``compiler`` (binary)rhCjśhIhJhKjUhM}r(hO]hP]hQ]hR]hU]uhWKčhY]r(h›)r}r(hBX ``compiler``hM}r(hO]hP]hQ]hR]hU]uhCjžhY]rhbXcompilerr…r}r (hBUhCjubahKh£ubhbX (binary)r …r }r (hBX (binary)hCjžubeubjb)r }r(hBUhM}r(hO]hP]hQ]hR]hU]uhCjśhY]rhu)r}r(hBXBThe configuration of the compiler being used to build the project.rhCj hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWKéhY]rhbXBThe configuration of the compiler being used to build the project.r…r}r(hBjhCjubaubahKj‚ubeubjK)r}r(hBX„``improved-plan`` (binary) Like ``solver-plan``, but with all non-inplace packages improved into pre-existing copies from the store.hCjFhIhJhKjNhM}r(hO]hP]hQ]hR]hU]uhWKėhXhhY]r(jQ)r}r(hBX``improved-plan`` (binary)rhCjhIhJhKjUhM}r (hO]hP]hQ]hR]hU]uhWKėhY]r!(h›)r"}r#(hBX``improved-plan``hM}r$(hO]hP]hQ]hR]hU]uhCjhY]r%hbX improved-planr&…r'}r((hBUhCj"ubahKh£ubhbX (binary)r)…r*}r+(hBX (binary)hCjubeubjb)r,}r-(hBUhM}r.(hO]hP]hQ]hR]hU]uhCjhY]r/hu)r0}r1(hBXiLike ``solver-plan``, but with all non-inplace packages improved into pre-existing copies from the store.hCj,hIhJhKhyhM}r2(hO]hP]hQ]hR]hU]uhWKėhY]r3(hbXLike r4…r5}r6(hBXLike hCj0ubh›)r7}r8(hBX``solver-plan``hM}r9(hO]hP]hQ]hR]hU]uhCj0hY]r:hbX solver-planr;…r<}r=(hBUhCj7ubahKh£ubhbXU, but with all non-inplace packages improved into pre-existing copies from the store.r>…r?}r@(hBXU, but with all non-inplace packages improved into pre-existing copies from the store.hCj0ubeubahKj‚ubeubjK)rA}rB(hBX£``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) hCjFhIhJhKjNhM}rC(hO]hP]hQ]hR]hU]uhWKųhXhhY]rD(jQ)rE}rF(hBX``plan.json`` (JSON)rGhCjAhIhJhKjUhM}rH(hO]hP]hQ]hR]hU]uhWKųhY]rI(h›)rJ}rK(hBX ``plan.json``hM}rL(hO]hP]hQ]hR]hU]uhCjEhY]rMhbX plan.jsonrN…rO}rP(hBUhCjJubahKh£ubhbX (JSON)rQ…rR}rS(hBX (JSON)hCjEubeubjb)rT}rU(hBUhM}rV(hO]hP]hQ]hR]hU]uhCjAhY]rW(hu)rX}rY(hBXAA 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.hCjThIhJhKhyhM}rZ(hO]hP]hQ]hR]hU]uhWKīhY]r[(hbXKA JSON serialization of the computed install plan intended for integrating r\…r]}r^(hBXKA JSON serialization of the computed install plan intended for integrating hCjXubh›)r_}r`(hBX ``cabal``hM}ra(hO]hP]hQ]hR]hU]uhCjXhY]rbhbXcabalrc…rd}re(hBUhCj_ubahKh£ubhbX with external tooling. The rf…rg}rh(hBX with external tooling. The hCjXubcdocutils.nodes reference ri)rj}rk(hBX>`cabal-plan `__hM}rl(UnameX cabal-planUrefurirmX-http://hackage.haskell.org/package/cabal-planhR]hQ]hO]hP]hU]uhCjXhY]rnhbX cabal-planro…rp}rq(hBUhCjjubahKU referencerrubhbX( package provides a library for parsing rs…rt}ru(hBX( package provides a library for parsing hCjXubh›)rv}rw(hBX ``plan.json``hM}rx(hO]hP]hQ]hR]hU]uhCjXhY]ryhbX plan.jsonrz…r{}r|(hBUhCjvubahKh£ubhbX^ files into a Haskell data structure as well as an example tool showing possible applications.r}…r~}r(hBX^ files into a Haskell data structure as well as an example tool showing possible applications.hCjXubeubcdocutils.nodes target r€)r}r‚(hBUhM}rƒ(hR]hQ]hO]hP]hU]Urefidr„Uindex-0r…uhCjThY]hKUtargetr†ubcsphinx.ext.todo todo_node r‡)rˆ}r‰(hBX:Document JSON schema (including version history of schema)rŠhCjThIhJUexpect_referenced_by_namer‹}hKU todo_noderŒhM}r(hO]hP]rŽUadmonition-todorahQ]hR]rj…ahU]uhWKõUexpect_referenced_by_idr‘}r’j…jshY]r“(h[)r”}r•(hBXTodor–hM}r—(hO]hP]hQ]hR]hU]uhCjˆhY]r˜hbXTodor™…rš}r›(hBUhCj”ubahKh_ubhu)rœ}r(hBjŠhCjˆhIhJhKhyhM}rž(hO]hP]hQ]hR]hU]uhWK÷hY]rŸhbX:Document JSON schema (including version history of schema)r …r”}r¢(hBjŠhCjœubaubeubehKj‚ubeubeubhu)r£}r¤(hBXnNote that every package also has a local cache managed by the Cabal build system, e.g., in ``$distdir/cache``.hCj hIhJhKhyhM}r„(hO]hP]hQ]hR]hU]uhWKśhXhhY]r¦(hbX[Note that every package also has a local cache managed by the Cabal build system, e.g., in r§…rØ}r©(hBX[Note that every package also has a local cache managed by the Cabal build system, e.g., in hINhWNhXhhCj£ubh›)rŖ}r«(hBX``$distdir/cache``hM}r¬(hO]hP]hQ]hR]hU]uhCj£hY]r­hbX$distdir/cacher®…rÆ}r°(hBUhCjŖubahKh£ubhbX.…r±}r²(hBX.hINhWNhXhhCj£ubeubhu)r³}r“(hBX¹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.hCj hIhJhKhyhM}rµ(hO]hP]hQ]hR]hU]uhWKżhXhhY]r¶(hbX There is another useful file in r·…rø}r¹(hBX There is another useful file in hINhWNhXhhCj³ubh›)rŗ}r»(hBX``dist-newstyle/cache``hM}r¼(hO]hP]hQ]hR]hU]uhCj³hY]r½hbXdist-newstyle/cacher¾…ræ}rĄ(hBUhCjŗubahKh£ubhbX, rĮ…rĀ}rĆ(hBX, hINhWNhXhhCj³ubh›)rÄ}rÅ(hBX ``plan.json``hM}rĘ(hO]hP]hQ]hR]hU]uhCj³hY]rĒhbX plan.jsonrČ…rÉ}rŹ(hBUhCjÄubahKh£ubhbXs, which is a JSON serialization of the computed install plan and is intended for integrating with external tooling.rĖ…rĢ}rĶ(hBXs, which is a JSON serialization of the computed install plan and is intended for integrating with external tooling.hINhWNhXhhCj³ubeubeubeubhIhJhKhLhM}rĪ(hO]hP]hQ]hR]rĻUlocal-versus-external-packagesrŠahU]rŃh2auhWKmhXhhY]rŅ(h[)rÓ}rŌ(hBXLocal versus external packagesrÕhChEhIhJhKh_hM}rÖ(hO]hP]hQ]hR]hU]uhWKmhXhhY]r×hbXLocal versus external packagesrŲ…rŁ}rŚ(hBjÕhINhWNhXhhCjÓubaubhu)rŪ}rÜ(hBXō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ŻhChEhIhJhKhyhM}rŽ(hO]hP]hQ]hR]hU]uhWKohXhhY]rßhbXō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į}rā(hBjŻhINhWNhXhhCjŪubaubcdocutils.nodes enumerated_list rć)rä}rå(hBUhChEhIhJhKUenumerated_listręhM}rē(UsuffixrčU.hR]hQ]hO]UprefixréUhP]hU]UenumtyperźUarabicrėuhWKthXhhY]rģhŽ)rķ}rī(hBXXA **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). hCjähIhJhKh‘hM}rļ(hO]hP]hQ]hR]hU]uhWNhXhhY]ršhu)rń}rņ(hBXWA **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).hCjķhIhJhKhyhM}ró(hO]hP]hQ]hR]hU]uhWKthY]rō(hbXA rõ…rö}r÷(hBXA hCjńubcdocutils.nodes strong rų)rł}rś(hBX**local package**hM}rū(hO]hP]hQ]hR]hU]uhCjńhY]rühbX local packagerż…rž}r’(hBUhCjłubahKUstrongrubhbX) is one that is listed explicitly in the r…r}r(hBX) is one that is listed explicitly in the hCjńubh›)r}r(hBX ``packages``hM}r(hO]hP]hQ]hR]hU]uhCjńhY]rhbXpackagesr…r }r (hBUhCjubahKh£ubhbX, r …r }r (hBX, hCjńubh›)r}r(hBX``optional-packages``hM}r(hO]hP]hQ]hR]hU]uhCjńhY]rhbXoptional-packagesr…r}r(hBUhCjubahKh£ubhbX or r…r}r(hBX or hCjńubh›)r}r(hBX``extra-packages``hM}r(hO]hP]hQ]hR]hU]uhCjńhY]rhbXextra-packagesr…r}r(hBUhCjubahKh£ubhbX« 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!(hBX« 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 hCjńubh›)r"}r#(hBX``extra-packages``hM}r$(hO]hP]hQ]hR]hU]uhCjńhY]r%hbXextra-packagesr&…r'}r((hBUhCj"ubahKh£ubhbX% to force it to be treated as local).r)…r*}r+(hBX% to force it to be treated as local).hCjńubeubaubaubhu)r,}r-(hBXOLocal 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.hChEhIhJhKhyhM}r.(hO]hP]hQ]hR]hU]uhWK{hXhhY]r/(hbXYLocal packages, as well as the external packages (below) which depend on them, are built r0…r1}r2(hBXYLocal packages, as well as the external packages (below) which depend on them, are built hINhWNhXhhCj,ubjų)r3}r4(hBX **inplace**hM}r5(hO]hP]hQ]hR]hU]uhCj,hY]r6hbXinplacer7…r8}r9(hBUhCj3ubahKjubhbXė, 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<(hBXė, 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.hINhWNhXhhCj,ubeubjć)r=}r>(hBUhChEhIhJhKjęhM}r?(jčU.Ustartr@KhR]hQ]hO]jéUhP]hU]jźjėuhWKhXhhY]rAhŽ)rB}rC(hBXŸ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. hCj=hIhJhKh‘hM}rD(hO]hP]hQ]hR]hU]uhWNhXhhY]rEhu)rF}rG(hBXž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.hCjBhIhJhKhyhM}rH(hO]hP]hQ]hR]hU]uhWKhY]rI(hbXAn rJ…rK}rL(hBXAn hCjFubjų)rM}rN(hBX**external package**hM}rO(hO]hP]hQ]hR]hU]uhCjFhY]rPhbXexternal packagerQ…rR}rS(hBUhCjMubahKjubhbX+ is any package which is not listed in the rT…rU}rV(hBX+ is any package which is not listed in the hCjFubh›)rW}rX(hBX ``packages``hM}rY(hO]hP]hQ]hR]hU]uhCjFhY]rZhbXpackagesr[…r\}r](hBUhCjWubahKh£ubhbXP field. The source code for external packages is usually retrieved from Hackage.r^…r_}r`(hBXP field. The source code for external packages is usually retrieved from Hackage.hCjFubeubaubaubhu)ra}rb(hBXś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.hChEhIhJhKhyhM}rc(hO]hP]hQ]hR]hU]uhWK…hXhhY]rd(hbXcWhen an external package does not depend on an inplace package, it can be built and installed to a re…rf}rg(hBXcWhen an external package does not depend on an inplace package, it can be built and installed to a hINhWNhXhhCjaubjų)rh}ri(hBX **global**hM}rj(hO]hP]hQ]hR]hU]uhCjahY]rkhbXglobalrl…rm}rn(hBUhCjhubahKjubhbX 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.ro…rp}rq(hBX 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.hINhWNhXhhCjaubeubhu)rr}rs(hBXFThe 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 (``new-build`` will just rebuild everything it needs on its next invocation).hChEhIhJhKhyhM}rt(hO]hP]hQ]hR]hU]uhWKŽhXhhY]ru(hbXThe global package store is rv…rw}rx(hBXThe global package store is hINhWNhXhhCjrubh›)ry}rz(hBX``~/.cabal/store``hM}r{(hO]hP]hQ]hR]hU]uhCjrhY]r|hbX~/.cabal/storer}…r~}r(hBUhCjyubahKh£ubhbX (configurable via global r€…r}r‚(hBX (configurable via global hINhWNhXhhCjrubcdocutils.nodes title_reference rƒ)r„}r…(hBX `store-dir`hM}r†(hO]hP]hQ]hR]hU]uhCjrhY]r‡hbX store-dirrˆ…r‰}rŠ(hBUhCj„ubahKUtitle_referencer‹ubhbX§ 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Ž(hBX§ 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 (hINhWNhXhhCjrubh›)r}r(hBX ``new-build``hM}r‘(hO]hP]hQ]hR]hU]uhCjrhY]r’hbX new-buildr“…r”}r•(hBUhCjubahKh£ubhbX? will just rebuild everything it needs on its next invocation).r–…r—}r˜(hBX? will just rebuild everything it needs on its next invocation).hINhWNhXhhCjrubeubhu)r™}rš(hBX/This split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to ``cabal new-build`` are only applied to *local* packages, so that adding a flag to ``cabal new-build`` doesn't necessitate a rebuild of *every* transitive dependency in the global package store.hChEhIhJhKhyhM}r›(hO]hP]hQ]hR]hU]uhWK”hXhhY]rœ(hbXmThis split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to r…rž}rŸ(hBXmThis split motivates some of the UI choices for Nix-style local build commands. For example, flags passed to hINhWNhXhhCj™ubh›)r }r”(hBX``cabal new-build``hM}r¢(hO]hP]hQ]hR]hU]uhCj™hY]r£hbXcabal new-buildr¤…r„}r¦(hBUhCj ubahKh£ubhbX are only applied to r§…rØ}r©(hBX are only applied to hINhWNhXhhCj™ubcdocutils.nodes emphasis rŖ)r«}r¬(hBX*local*hM}r­(hO]hP]hQ]hR]hU]uhCj™hY]r®hbXlocalrÆ…r°}r±(hBUhCj«ubahKUemphasisr²ubhbX$ packages, so that adding a flag to r³…r“}rµ(hBX$ packages, so that adding a flag to hINhWNhXhhCj™ubh›)r¶}r·(hBX``cabal new-build``hM}rø(hO]hP]hQ]hR]hU]uhCj™hY]r¹hbXcabal new-buildrŗ…r»}r¼(hBUhCj¶ubahKh£ubhbX$ doesnā€™t necessitate a rebuild of r½…r¾}ræ(hBX" doesn't necessitate a rebuild of hINhWNhXhhCj™ubjŖ)rĄ}rĮ(hBX*every*hM}rĀ(hO]hP]hQ]hR]hU]uhCj™hY]rĆhbXeveryrÄ…rÅ}rĘ(hBUhCjĄubahKj²ubhbX3 transitive dependency in the global package store.rĒ…rČ}rÉ(hBX3 transitive dependency in the global package store.hINhWNhXhhCj™ubeubhu)rŹ}rĖ(hBX*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.hChEhIhJhKhyhM}rĢ(hO]hP]hQ]hR]hU]uhWKšhXhhY]rĶ(hbXkIn cabal-install 2.0 and above, Nix-style local builds also take advantage of a new Cabal library feature, rĪ…rĻ}rŠ(hBXkIn cabal-install 2.0 and above, Nix-style local builds also take advantage of a new Cabal library feature, hINhWNhXhhCjŹubji)rŃ}rŅ(hBXu`per-component builds `__hM}rÓ(UnameXper-component buildsjmXZhttps://github.com/ezyang/ghc-proposals/blob/master/proposals/0000-componentized-cabal.rsthR]hQ]hO]hP]hU]uhCjŹhY]rŌhbXper-component buildsrÕ…rÖ}r×(hBUhCjŃubahKjrubhbXJ, 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.rŲ…rŁ}rŚ(hBXJ, 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.hINhWNhXhhCjŹubeubeubhIhJhKUsystem_messagerŪhM}rÜ(hO]UlevelKhR]hQ]UsourcehJhP]hU]UlineKjUtypeUINFOrŻuhWKhXhhY]rŽhu)rß}rą(hBX:Enumerated list start value not ordinal-1: "2" (ordinal 2)hM}rį(hO]hP]hQ]hR]hU]uhCh@hY]rāhbX>Enumerated list start value not ordinal-1: ā€œ2ā€ (ordinal 2)r慁rä}rå(hBUhCjßubahKhyubaubh?)rę}rē(hBUhM}rč(hO]UlevelKhR]hQ]UsourcehJhP]hU]UlineMUUtypeUERRORréuhChŽ)rź}rė(hBX%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``. hCh‡)rģ}rķ(hBUhChD)rī}rļ(hBUhChD)rš}rń(hBUhChhIhJhKhLhM}rņ(hO]hP]hQ]hR]róUcommandsrōahU]rõh(auhWMhXhhY]rö(h[)r÷}rų(hBXCommandsrłhCjšhIhJhKh_hM}rś(hO]hP]hQ]hR]hU]uhWMhXhhY]rūhbXCommandsrü…rż}rž(hBjłhINhWNhXhhCj÷ubaubhu)r’}r(hBXhWe now give an in-depth description of all the commands, describing the arguments and flags they accept.rhCjšhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMhXhhY]rhbXhWe now give an in-depth description of all the commands, describing the arguments and flags they accept.r…r}r(hBjhINhWNhXhhCj’ubaubhD)r}r(hBUhCjšhIhJhKhLhM}r (hO]hP]hQ]hR]r Ucabal-new-configurer ahU]r hauhWM hXhhY]r (h[)r}r(hBXcabal new-configurerhCjhIhJhKh_hM}r(hO]hP]hQ]hR]hU]uhWM hXhhY]rhbXcabal new-configurer…r}r(hBjhINhWNhXhhCjubaubhu)r}r(hBXM``cabal new-configure`` takes a set of arguments and writes a ``cabal.project.local`` file based on the flags passed to this command. ``cabal new-configure FLAGS; cabal new-build`` is roughly equivalent to ``cabal new-build FLAGS``, except that with ``new-configure`` the flags are persisted to all subsequent calls to ``new-build``.hCjhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM hXhhY]r(h›)r}r(hBX``cabal new-configure``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbXcabal new-configurer…r}r (hBUhCjubahKh£ubhbX' takes a set of arguments and writes a r!…r"}r#(hBX' takes a set of arguments and writes a hINhWNhXhhCjubh›)r$}r%(hBX``cabal.project.local``hM}r&(hO]hP]hQ]hR]hU]uhCjhY]r'hbXcabal.project.localr(…r)}r*(hBUhCj$ubahKh£ubhbX1 file based on the flags passed to this command. r+…r,}r-(hBX1 file based on the flags passed to this command. hINhWNhXhhCjubh›)r.}r/(hBX.``cabal new-configure FLAGS; cabal new-build``hM}r0(hO]hP]hQ]hR]hU]uhCjhY]r1hbX*cabal new-configure FLAGS; cabal new-buildr2…r3}r4(hBUhCj.ubahKh£ubhbX is roughly equivalent to r5…r6}r7(hBX is roughly equivalent to hINhWNhXhhCjubh›)r8}r9(hBX``cabal new-build FLAGS``hM}r:(hO]hP]hQ]hR]hU]uhCjhY]r;hbXcabal new-build FLAGSr<…r=}r>(hBUhCj8ubahKh£ubhbX, except that with r?…r@}rA(hBX, except that with hINhWNhXhhCjubh›)rB}rC(hBX``new-configure``hM}rD(hO]hP]hQ]hR]hU]uhCjhY]rEhbX new-configurerF…rG}rH(hBUhCjBubahKh£ubhbX4 the flags are persisted to all subsequent calls to rI…rJ}rK(hBX4 the flags are persisted to all subsequent calls to hINhWNhXhhCjubh›)rL}rM(hBX ``new-build``hM}rN(hO]hP]hQ]hR]hU]uhCjhY]rOhbX new-buildrP…rQ}rR(hBUhCjLubahKh£ubhbX.…rS}rT(hBX.hINhWNhXhhCjubeubhu)rU}rV(hBX˜``cabal new-configure`` is intended to be a convenient way to write out a ``cabal.project.local`` for simple configurations; e.g., ``cabal new-configure -w ghc-7.8`` would ensure that all subsequent builds with ``cabal new-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``!)hCjhIhJhKhyhM}rW(hO]hP]hQ]hR]hU]uhWMhXhhY]rX(h›)rY}rZ(hBX``cabal new-configure``hM}r[(hO]hP]hQ]hR]hU]uhCjUhY]r\hbXcabal new-configurer]…r^}r_(hBUhCjYubahKh£ubhbX3 is intended to be a convenient way to write out a r`…ra}rb(hBX3 is intended to be a convenient way to write out a hINhWNhXhhCjUubh›)rc}rd(hBX``cabal.project.local``hM}re(hO]hP]hQ]hR]hU]uhCjUhY]rfhbXcabal.project.localrg…rh}ri(hBUhCjcubahKh£ubhbX" for simple configurations; e.g., rj…rk}rl(hBX" for simple configurations; e.g., hINhWNhXhhCjUubh›)rm}rn(hBX"``cabal new-configure -w ghc-7.8``hM}ro(hO]hP]hQ]hR]hU]uhCjUhY]rphbXcabal new-configure -w ghc-7.8rq…rr}rs(hBUhCjmubahKh£ubhbX. would ensure that all subsequent builds with rt…ru}rv(hBX. would ensure that all subsequent builds with hINhWNhXhhCjUubh›)rw}rx(hBX``cabal new-build``hM}ry(hO]hP]hQ]hR]hU]uhCjUhY]rzhbXcabal new-buildr{…r|}r}(hBUhCjwubahKh£ubhbX! are performed with the compiler r~…r}r€(hBX! are performed with the compiler hINhWNhXhhCjUubh›)r}r‚(hBX ``ghc-7.8``hM}rƒ(hO]hP]hQ]hR]hU]uhCjUhY]r„hbXghc-7.8r……r†}r‡(hBUhCjubahKh£ubhbX;. For more complex configuration, we recommend writing the rˆ…r‰}rŠ(hBX;. For more complex configuration, we recommend writing the hINhWNhXhhCjUubh›)r‹}rŒ(hBX``cabal.project.local``hM}r(hO]hP]hQ]hR]hU]uhCjUhY]rŽhbXcabal.project.localr…r}r‘(hBUhCj‹ubahKh£ubhbX! file directly (or placing it in r’…r“}r”(hBX! file directly (or placing it in hINhWNhXhhCjUubh›)r•}r–(hBX``cabal.project``hM}r—(hO]hP]hQ]hR]hU]uhCjUhY]r˜hbX cabal.projectr™…rš}r›(hBUhCj•ubahKh£ubhbX!)rœ…r}rž(hBX!)hINhWNhXhhCjUubeubhu)rŸ}r (hBXC``cabal new-configure`` inherits options from ``Cabal``. semantics:r”hCjhIhJhKhyhM}r¢(hO]hP]hQ]hR]hU]uhWMhXhhY]r£(h›)r¤}r„(hBX``cabal new-configure``hM}r¦(hO]hP]hQ]hR]hU]uhCjŸhY]r§hbXcabal new-configurerØ…r©}rŖ(hBUhCj¤ubahKh£ubhbX inherits options from r«…r¬}r­(hBX inherits options from hINhWNhXhhCjŸubh›)r®}rÆ(hBX ``Cabal``hM}r°(hO]hP]hQ]hR]hU]uhCjŸhY]r±hbXCabalr²…r³}r“(hBUhCj®ubahKh£ubhbX . semantics:rµ…r¶}r·(hBX . semantics:hINhWNhXhhCjŸubeubh‡)rø}r¹(hBUhCjhIhJhKhŠhM}rŗ(hŒX-hR]hQ]hO]hP]hU]uhWMhXhhY]r»(hŽ)r¼}r½(hBX,Any flag accepted by ``./Setup configure``. hCjøhIhJhKh‘hM}r¾(hO]hP]hQ]hR]hU]uhWNhXhhY]ræhu)rĄ}rĮ(hBX+Any flag accepted by ``./Setup configure``.hCj¼hIhJhKhyhM}rĀ(hO]hP]hQ]hR]hU]uhWMhY]rĆ(hbXAny flag accepted by rÄ…rÅ}rĘ(hBXAny flag accepted by hCjĄubh›)rĒ}rČ(hBX``./Setup configure``hM}rÉ(hO]hP]hQ]hR]hU]uhCjĄhY]rŹhbX./Setup configurerĖ…rĢ}rĶ(hBUhCjĒubahKh£ubhbX.…rĪ}rĻ(hBX.hCjĄubeubaubhŽ)rŠ}rŃ(hBXœAny flag accepted by ``cabal configure`` beyond ``./Setup configure``, namely ``--cabal-lib-version``, ``--constraint``, ``--preference`` and ``--solver.`` hCjøhIhJhKh‘hM}rŅ(hO]hP]hQ]hR]hU]uhWNhXhhY]rÓhu)rŌ}rÕ(hBX›Any flag accepted by ``cabal configure`` beyond ``./Setup configure``, namely ``--cabal-lib-version``, ``--constraint``, ``--preference`` and ``--solver.``hCjŠhIhJhKhyhM}rÖ(hO]hP]hQ]hR]hU]uhWMhY]r×(hbXAny flag accepted by rŲ…rŁ}rŚ(hBXAny flag accepted by hCjŌubh›)rŪ}rÜ(hBX``cabal configure``hM}rŻ(hO]hP]hQ]hR]hU]uhCjŌhY]rŽhbXcabal configurerß…rą}rį(hBUhCjŪubahKh£ubhbX beyond rā…rć}rä(hBX beyond hCjŌubh›)rå}rę(hBX``./Setup configure``hM}rē(hO]hP]hQ]hR]hU]uhCjŌhY]rčhbX./Setup configurer酁rź}rė(hBUhCjåubahKh£ubhbX , namely rģ…rķ}rī(hBX , namely hCjŌubh›)rļ}rš(hBX``--cabal-lib-version``hM}rń(hO]hP]hQ]hR]hU]uhCjŌhY]rņhbX--cabal-lib-versionró…rō}rõ(hBUhCjļubahKh£ubhbX, rö…r÷}rų(hBX, hCjŌubh›)rł}rś(hBX``--constraint``hM}rū(hO]hP]hQ]hR]hU]uhCjŌhY]rühbX --constraintrż…rž}r’(hBUhCjłubahKh£ubhbX, r…r}r(hBX, hCjŌubh›)r}r(hBX``--preference``hM}r(hO]hP]hQ]hR]hU]uhCjŌhY]rhbX --preferencer…r}r (hBUhCjubahKh£ubhbX and r …r }r (hBX and hCjŌubh›)r }r(hBX ``--solver.``hM}r(hO]hP]hQ]hR]hU]uhCjŌhY]rhbX --solver.r…r}r(hBUhCj ubahKh£ubeubaubhŽ)r}r(hBXEAny flag accepted by ``cabal install`` beyond ``./Setup configure``. hCjøhIhJhKh‘hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rhu)r}r(hBXDAny flag accepted by ``cabal install`` beyond ``./Setup configure``.hCjhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM#hY]r(hbXAny flag accepted by r…r}r(hBXAny flag accepted by hCjubh›)r}r (hBX``cabal install``hM}r!(hO]hP]hQ]hR]hU]uhCjhY]r"hbX cabal installr#…r$}r%(hBUhCjubahKh£ubhbX beyond r&…r'}r((hBX beyond hCjubh›)r)}r*(hBX``./Setup configure``hM}r+(hO]hP]hQ]hR]hU]uhCjhY]r,hbX./Setup configurer-…r.}r/(hBUhCj)ubahKh£ubhbX.…r0}r1(hBX.hCjubeubaubhŽ)r2}r3(hBX*Any flag accepted by ``./Setup haddock``. hCjøhIhJhKh‘hM}r4(hO]hP]hQ]hR]hU]uhWNhXhhY]r5hu)r6}r7(hBX)Any flag accepted by ``./Setup haddock``.hCj2hIhJhKhyhM}r8(hO]hP]hQ]hR]hU]uhWM%hY]r9(hbXAny flag accepted by r:…r;}r<(hBXAny flag accepted by hCj6ubh›)r=}r>(hBX``./Setup haddock``hM}r?(hO]hP]hQ]hR]hU]uhCj6hY]r@hbX./Setup haddockrA…rB}rC(hBUhCj=ubahKh£ubhbX.…rD}rE(hBX.hCj6ubeubaubeubhu)rF}rG(hBXThe 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.hCjhIhJhKhyhM}rH(hO]hP]hQ]hR]hU]uhWM'hXhhY]rI(hbX0The options of all of these flags apply only to rJ…rK}rL(hBX0The options of all of these flags apply only to hINhWNhXhhCjFubjŖ)rM}rN(hBX*local*hM}rO(hO]hP]hQ]hR]hU]uhCjFhY]rPhbXlocalrQ…rR}rS(hBUhCjMubahKj²ubhbX@ packages in a project; this behavior is different than that of rT…rU}rV(hBX@ packages in a project; this behavior is different than that of hINhWNhXhhCjFubh›)rW}rX(hBX``cabal install``hM}rY(hO]hP]hQ]hR]hU]uhCjFhY]rZhbX cabal installr[…r\}r](hBUhCjWubahKh£ubhbXL, 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`(hBXL, 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 hINhWNhXhhCjFubh›)ra}rb(hBX ``package``hM}rc(hO]hP]hQ]hR]hU]uhCjFhY]rdhbXpackagere…rf}rg(hBUhCjaubahKh£ubhbX stanza in a rh…ri}rj(hBX stanza in a hINhWNhXhhCjFubh›)rk}rl(hBX``cabal.project``hM}rm(hO]hP]hQ]hR]hU]uhCjFhY]rnhbX cabal.projectro…rp}rq(hBUhCjkubahKh£ubhbX file.rr…rs}rt(hBX file.hINhWNhXhhCjFubeubeubhD)ru}rv(hBUhCjšhIhJhKhLhM}rw(hO]hP]hQ]hR]rxUcabal-new-updateryahU]rzhauhWM1hXhhY]r{(h[)r|}r}(hBXcabal new-updater~hCjuhIhJhKh_hM}r(hO]hP]hQ]hR]hU]uhWM1hXhhY]r€hbXcabal new-updater…r‚}rƒ(hBj~hINhWNhXhhCj|ubaubhu)r„}r…(hBX½``cabal new-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).hCjuhIhJhKhyhM}r†(hO]hP]hQ]hR]hU]uhWM3hXhhY]r‡(h›)rˆ}r‰(hBX``cabal new-update``hM}rŠ(hO]hP]hQ]hR]hU]uhCj„hY]r‹hbXcabal new-updaterŒ…r}rŽ(hBUhCjˆubahKh£ubhbX© 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‘(hBX© 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).hINhWNhXhhCj„ubeubhu)r’}r“(hBXSeom examples:r”hCjuhIhJhKhyhM}r•(hO]hP]hQ]hR]hU]uhWM7hXhhY]r–hbXSeom examples:r—…r˜}r™(hBj”hINhWNhXhhCj’ubaubcdocutils.nodes literal_block rš)r›}rœ(hBX|$ cabal new-update # update all remote repos $ cabal new-update head.hackage # update only head.hackagehCjuhIhJhKU literal_blockrhM}rž(U xml:spacerŸUpreserver hR]hQ]hO]hP]hU]uhWM;hXhhY]r”hbX|$ cabal new-update # update all remote repos $ cabal new-update head.hackage # update only head.hackager¢…r£}r¤(hBUhCj›ubaubeubjīhD)r„}r¦(hBUhCjšhIhJhKhLhM}r§(hO]hP]hQ]hR]rØUcabal-new-replr©ahU]rŖh auhWMthXhhY]r«(h[)r¬}r­(hBXcabal new-replr®hCj„hIhJhKh_hM}rÆ(hO]hP]hQ]hR]hU]uhWMthXhhY]r°hbXcabal new-replr±…r²}r³(hBj®hINhWNhXhhCj¬ubaubhu)r“}rµ(hBXæ``cabal new-repl TARGET`` loads all of the modules of the target into GHCi as interpreted bytecode. In addition to ``cabal new-build``'s flags, it takes an additional ``--repl-options`` flag.hCj„hIhJhKhyhM}r¶(hO]hP]hQ]hR]hU]uhWMvhXhhY]r·(h›)rø}r¹(hBX``cabal new-repl TARGET``hM}rŗ(hO]hP]hQ]hR]hU]uhCj“hY]r»hbXcabal new-repl TARGETr¼…r½}r¾(hBUhCjøubahKh£ubhbXZ loads all of the modules of the target into GHCi as interpreted bytecode. In addition to r慁rĄ}rĮ(hBXZ loads all of the modules of the target into GHCi as interpreted bytecode. In addition to hINhWNhXhhCj“ubh›)rĀ}rĆ(hBX``cabal new-build``hM}rÄ(hO]hP]hQ]hR]hU]uhCj“hY]rÅhbXcabal new-buildrĘ…rĒ}rČ(hBUhCjĀubahKh£ubhbX#ā€™s flags, it takes an additional rÉ…rŹ}rĖ(hBX!'s flags, it takes an additional hINhWNhXhhCj“ubh›)rĢ}rĶ(hBX``--repl-options``hM}rĪ(hO]hP]hQ]hR]hU]uhCj“hY]rĻhbX--repl-optionsrŠ…rŃ}rŅ(hBUhCjĢubahKh£ubhbX flag.rÓ…rŌ}rÕ(hBX flag.hINhWNhXhhCj“ubeubhu)rÖ}r×(hBX¹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.)hCj„hIhJhKhyhM}rŲ(hO]hP]hQ]hR]hU]uhWMzhXhhY]rŁ(hbX To avoid rŚ…rŪ}rÜ(hBX To avoid hINhWNhXhhCjÖubh›)rŻ}rŽ(hBX``ghci``hM}rß(hO]hP]hQ]hR]hU]uhCjÖhY]rąhbXghcirį…rā}rć(hBUhCjŻubahKh£ubhbXƒ specific flags from triggering unneeded global rebuilds these flags are now stripped from the internal configuration. As a result r䅁rå}rę(hBXƒ specific flags from triggering unneeded global rebuilds these flags are now stripped from the internal configuration. As a result hINhWNhXhhCjÖubh›)rē}rč(hBX``--ghc-options``hM}ré(hO]hP]hQ]hR]hU]uhCjÖhY]rźhbX --ghc-optionsrė…rģ}rķ(hBUhCjēubahKh£ubhbX1 will no longer (reliably) work to pass flags to rī…rļ}rš(hBX1 will no longer (reliably) work to pass flags to hINhWNhXhhCjÖubh›)rń}rņ(hBX``ghci``hM}ró(hO]hP]hQ]hR]hU]uhCjÖhY]rōhbXghcirõ…rö}r÷(hBUhCjńubahKh£ubhbX3 (or other repls). Instead, you should use the new rų…rł}rś(hBX3 (or other repls). Instead, you should use the new hINhWNhXhhCjÖubh›)rū}rü(hBX``--repl-options``hM}rż(hO]hP]hQ]hR]hU]uhCjÖhY]ržhbX--repl-optionsr’…r}r(hBUhCjūubahKh£ubhbXM flag to specify these options to the invoked repl. (This flag also works on r…r}r(hBXM flag to specify these options to the invoked repl. (This flag also works on hINhWNhXhhCjÖubh›)r}r(hBX``cabal repl``hM}r(hO]hP]hQ]hR]hU]uhCjÖhY]rhbX cabal replr …r }r (hBUhCjubahKh£ubhbX and r …r }r(hBX and hINhWNhXhhCjÖubh›)r}r(hBX``Setup repl``hM}r(hO]hP]hQ]hR]hU]uhCjÖhY]rhbX Setup replr…r}r(hBUhCjubahKh£ubhbX( on sufficiently new versions of Cabal.)r…r}r(hBX( on sufficiently new versions of Cabal.)hINhWNhXhhCjÖubeubhu)r}r(hBX›Currently, it is not supported to pass multiple targets to ``new-repl`` (``new-repl`` will just successively open a separate GHCi session for each target.)hCj„hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMhXhhY]r(hbX;Currently, it is not supported to pass multiple targets to r…r}r(hBX;Currently, it is not supported to pass multiple targets to hINhWNhXhhCjubh›)r }r!(hBX ``new-repl``hM}r"(hO]hP]hQ]hR]hU]uhCjhY]r#hbXnew-replr$…r%}r&(hBUhCj ubahKh£ubhbX (r'…r(}r)(hBX (hINhWNhXhhCjubh›)r*}r+(hBX ``new-repl``hM}r,(hO]hP]hQ]hR]hU]uhCjhY]r-hbXnew-replr.…r/}r0(hBUhCj*ubahKh£ubhbXF will just successively open a separate GHCi session for each target.)r1…r2}r3(hBXF will just successively open a separate GHCi session for each target.)hINhWNhXhhCjubeubhu)r4}r5(hBXzIt also provides a way to experiment with libraries without needing to download them manually or to install them globally.r6hCj„hIhJhKhyhM}r7(hO]hP]hQ]hR]hU]uhWM…hXhhY]r8hbXzIt also provides a way to experiment with libraries without needing to download them manually or to install them globally.r9…r:}r;(hBj6hINhWNhXhhCj4ubaubhu)r<}r=(hBXŽThis command opens a REPL with the current default target loaded, and a version of the ``vector`` package matching that specification exposed.hCj„hIhJhKhyhM}r>(hO]hP]hQ]hR]hU]uhWMˆhXhhY]r?(hbXWThis command opens a REPL with the current default target loaded, and a version of the r@…rA}rB(hBXWThis command opens a REPL with the current default target loaded, and a version of the hINhWNhXhhCj<ubh›)rC}rD(hBX ``vector``hM}rE(hO]hP]hQ]hR]hU]uhCj<hY]rFhbXvectorrG…rH}rI(hBUhCjCubahKh£ubhbX- package matching that specification exposed.rJ…rK}rL(hBX- package matching that specification exposed.hINhWNhXhhCj<ubeubjš)rM}rN(hBX;$ cabal new-repl --build-depends "vector >= 0.12 && < 0.13"hCj„hIhJhKjhM}rO(jŸj hR]hQ]hO]hP]hU]uhWMhXhhY]rPhbX;$ cabal new-repl --build-depends "vector >= 0.12 && < 0.13"rQ…rR}rS(hBUhCjMubaubhu)rT}rU(hBX»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.hCj„hIhJhKhyhM}rV(hO]hP]hQ]hR]hU]uhWMhXhhY]rW(hbXHBoth of these commands do the same thing as the above, but only exposes rX…rY}rZ(hBXHBoth of these commands do the same thing as the above, but only exposes hINhWNhXhhCjTubh›)r[}r\(hBX``base``hM}r](hO]hP]hQ]hR]hU]uhCjThY]r^hbXbaser_…r`}ra(hBUhCj[ubahKh£ubhbX, rb…rc}rd(hBX, hINhWNhXhhCjTubh›)re}rf(hBX ``vector``hM}rg(hO]hP]hQ]hR]hU]uhCjThY]rhhbXvectorri…rj}rk(hBUhCjeubahKh£ubhbXa, and the``vector`` packageā€™s transitive dependencies even if the user is in a project context.rl…rm}rn(hBX_, and the``vector`` package's transitive dependencies even if the user is in a project context.hINhWNhXhhCjTubeubjš)ro}rp(hBX•$ cabal new-repl --ignore-project --build-depends "vector >= 0.12 && < 0.13" $ cabal new-repl --project='' --build-depends "vector >= 0.12 && < 0.13"hCj„hIhJhKjhM}rq(jŸj hR]hQ]hO]hP]hU]uhWM•hXhhY]rrhbX•$ cabal new-repl --ignore-project --build-depends "vector >= 0.12 && < 0.13" $ cabal new-repl --project='' --build-depends "vector >= 0.12 && < 0.13"rs…rt}ru(hBUhCjoubaubhu)rv}rw(hBXĖ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).hCj„hIhJhKhyhM}rx(hO]hP]hQ]hR]hU]uhWM˜hXhhY]ry(hbXThis command would add rz…r{}r|(hBXThis command would add hINhWNhXhhCjvubh›)r}}r~(hBX ``vector``hM}r(hO]hP]hQ]hR]hU]uhCjvhY]r€hbXvectorr…r‚}rƒ(hBUhCj}ubahKh£ubhbX, but not (for example) r„…r…}r†(hBX, but not (for example) hINhWNhXhhCjvubh›)r‡}rˆ(hBX ``primitive``hM}r‰(hO]hP]hQ]hR]hU]uhCjvhY]rŠhbX primitiver‹…rŒ}r(hBUhCj‡ubahKh£ubhbXK, because it only includes the packages specified on the command line (and rŽ…r}r(hBXK, because it only includes the packages specified on the command line (and hINhWNhXhhCjvubh›)r‘}r’(hBX``base``hM}r“(hO]hP]hQ]hR]hU]uhCjvhY]r”hbXbaser•…r–}r—(hBUhCj‘ubahKh£ubhbX2, which cannot be excluded for technical reasons).r˜…r™}rš(hBX2, which cannot be excluded for technical reasons).hINhWNhXhhCjvubeubjš)r›}rœ(hBX<$ cabal new-repl --build-depends vector --no-transitive-depshCj„hIhJhKjhM}r(jŸj hR]hQ]hO]hP]hU]uhWMžhXhhY]ržhbX<$ cabal new-repl --build-depends vector --no-transitive-depsrŸ…r }r”(hBUhCj›ubaubeubhD)r¢}r£(hBUhCjšhIhJhKhLhM}r¤(hO]hP]hQ]hR]r„U cabal-new-runr¦ahU]r§h1auhWM”hXhhY]rØ(h[)r©}rŖ(hBX cabal new-runr«hCj¢hIhJhKh_hM}r¬(hO]hP]hQ]hR]hU]uhWM”hXhhY]r­hbX cabal new-runr®…rÆ}r°(hBj«hINhWNhXhhCj©ubaubhu)r±}r²(hBX``cabal new-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.hCj¢hIhJhKhyhM}r³(hO]hP]hQ]hR]hU]uhWM£hXhhY]r“(h›)rµ}r¶(hBX!``cabal new-run [TARGET [ARGS]]``hM}r·(hO]hP]hQ]hR]hU]uhCj±hY]røhbXcabal new-run [TARGET [ARGS]]r¹…rŗ}r»(hBUhCjµubahKh£ubhbXć 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.r¼…r½}r¾(hBXć 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.hINhWNhXhhCj±ubeubhu)ræ}rĄ(hBXGSee `the new-build section <#cabal-new-build>`__ for the target syntax.rĮhCj¢hIhJhKhyhM}rĀ(hO]hP]hQ]hR]hU]uhWMØhXhhY]rĆ(hbXSee rÄ…rÅ}rĘ(hBXSee hINhWNhXhhCjæubji)rĒ}rČ(hBX,`the new-build section <#cabal-new-build>`__hM}rÉ(UnameXthe new-build sectionjmX#cabal-new-buildhR]hQ]hO]hP]hU]uhCjæhY]rŹhbXthe new-build sectionrĖ…rĢ}rĶ(hBUhCjĒubahKjrubhbX for the target syntax.rĪ…rĻ}rŠ(hBX for the target syntax.hINhWNhXhhCjæubeubhu)rŃ}rŅ(hBXkExcept in the case of the empty target, the strings after it will be passed to the executable as arguments.rÓhCj¢hIhJhKhyhM}rŌ(hO]hP]hQ]hR]hU]uhWMŖhXhhY]rÕhbXkExcept in the case of the empty target, the strings after it will be passed to the executable as arguments.rÖ…r×}rŲ(hBjÓhINhWNhXhhCjŃubaubhu)rŁ}rŚ(hBX§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 ``--``.hCj¢hIhJhKhyhM}rŪ(hO]hP]hQ]hR]hU]uhWM­hXhhY]rÜ(hbX$If one of the arguments starts with rŻ…rŽ}rß(hBX$If one of the arguments starts with hINhWNhXhhCjŁubh›)rą}rį(hBX``-``hM}rā(hO]hP]hQ]hR]hU]uhCjŁhY]rćhbX-…rä}rå(hBUhCjąubahKh£ubhbXw it will be interpreted as a cabal flag, so if you need to pass flags to the executable you have to separate them with rꅁrē}rč(hBXw it will be interpreted as a cabal flag, so if you need to pass flags to the executable you have to separate them with hINhWNhXhhCjŁubh›)ré}rź(hBX``--``hM}rė(hO]hP]hQ]hR]hU]uhCjŁhY]rģhbX--rķ…rī}rļ(hBUhCjéubahKh£ubhbX.…rš}rń(hBX.hINhWNhXhhCjŁubeubjš)rņ}ró(hBX,$ cabal new-run target -- -a -bcd --argumenthCj¢hIhJhKjhM}rō(jŸj hR]hQ]hO]hP]hU]uhWM³hXhhY]rõhbX,$ cabal new-run target -- -a -bcd --argumentrö…r÷}rų(hBUhCjņubaubhu)rł}rś(hBXf'new-run' also supports running script files that use a certain format. With a script that looks like:rūhCj¢hIhJhKhyhM}rü(hO]hP]hQ]hR]hU]uhWMµhXhhY]rżhbXjā€˜new-runā€™ also supports running script files that use a certain format. With a script that looks like:rž…r’}r(hBjūhINhWNhXhhCjłubaubjš)r}r(hBX~#!/usr/bin/env cabal {- cabal: build-depends: base ^>= 4.11 , shelly ^>= 1.8.1 -} main :: IO () main = do ...hCj¢hIhJhKjhM}r(jŸj hR]hQ]hO]hP]hU]uhWMŗhXhhY]rhbX~#!/usr/bin/env cabal {- cabal: build-depends: base ^>= 4.11 , shelly ^>= 1.8.1 -} main :: IO () main = do ...r…r}r(hBUhCjubaubhu)r}r (hBXlIt can either be executed like any other script, using ``cabal`` as an interpreter, or through this command:hCj¢hIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMÄhXhhY]r (hbX7It can either be executed like any other script, using r …r }r(hBX7It can either be executed like any other script, using hINhWNhXhhCjubh›)r}r(hBX ``cabal``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbXcabalr…r}r(hBUhCjubahKh£ubhbX, as an interpreter, or through this command:r…r}r(hBX, as an interpreter, or through this command:hINhWNhXhhCjubeubjš)r}r(hBXY$ cabal new-run script.hs $ cabal new-run script.hs -- --arg1 # args are passed like thishCj¢hIhJhKjhM}r(jŸj hR]hQ]hO]hP]hU]uhWMÉhXhhY]rhbXY$ cabal new-run script.hs $ cabal new-run script.hs -- --arg1 # args are passed like thisr…r}r(hBUhCjubaubeubhD)r }r!(hBUhCjšhIhJhKhLhM}r"(hO]hP]hQ]hR]r#Ucabal-new-freezer$ahU]r%hauhWMĶhXhhY]r&(h[)r'}r((hBXcabal new-freezer)hCj hIhJhKh_hM}r*(hO]hP]hQ]hR]hU]uhWMĶhXhhY]r+hbXcabal new-freezer,…r-}r.(hBj)hINhWNhXhhCj'ubaubhu)r/}r0(hBXÉ``cabal new-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:hCj hIhJhKhyhM}r1(hO]hP]hQ]hR]hU]uhWMĻhXhhY]r2(h›)r3}r4(hBX``cabal new-freeze``hM}r5(hO]hP]hQ]hR]hU]uhCj/hY]r6hbXcabal new-freezer7…r8}r9(hBUhCj3ubahKh£ubhbX writes out a r:…r;}r<(hBX writes out a hINhWNhXhhCj/ubjų)r=}r>(hBX**freeze file**hM}r?(hO]hP]hQ]hR]hU]uhCj/hY]r@hbX freeze filerA…rB}rC(hBUhCj=ubahKjubhbX’ 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 rD…rE}rF(hBX’ 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 hINhWNhXhhCj/ubh›)rG}rH(hBX``cabal.project.freeze``hM}rI(hO]hP]hQ]hR]hU]uhCj/hY]rJhbXcabal.project.freezerK…rL}rM(hBUhCjGubahKh£ubhbX but in combination with a rN…rO}rP(hBX but in combination with a hINhWNhXhhCj/ubh›)rQ}rR(hBX``--project-file=my.project``hM}rS(hO]hP]hQ]hR]hU]uhCj/hY]rThbX--project-file=my.projectrU…rV}rW(hBUhCjQubahKh£ubhbX flag (see rX…rY}rZ(hBX flag (see hINhWNhXhhCj/ubcsphinx.addnodes pending_xref r[)r\}r](hBX,:ref:`project-file `r^hCj/hIhJhKU pending_xrefr_hM}r`(UreftypeXrefUrefwarnraˆU reftargetrbXcmdoption-project-fileU refdomainXstdrchR]hQ]U refexplicitˆhO]hP]hU]UrefdocrdXnix-local-buildreuhWMĻhY]rfcdocutils.nodes inline rg)rh}ri(hBj^hM}rj(hO]hP]rk(UxrefrljcXstd-refrmehQ]hR]hU]uhCj\hY]rnhbX project-filero…rp}rq(hBUhCjhubahKUinlinerrubaubhbX) the name will be rs…rt}ru(hBX) the name will be hINhWNhXhhCj/ubh›)rv}rw(hBX``my.project.freeze``hM}rx(hO]hP]hQ]hR]hU]uhCj/hY]ryhbXmy.project.freezerz…r{}r|(hBUhCjvubahKh£ubhbX'. A freeze file has the same syntax as r}…r~}r(hBX'. A freeze file has the same syntax as hINhWNhXhhCj/ubh›)r€}r(hBX``cabal.project``hM}r‚(hO]hP]hQ]hR]hU]uhCj/hY]rƒhbX cabal.projectr„…r…}r†(hBUhCj€ubahKh£ubhbX and looks something like this:r‡…rˆ}r‰(hBX and looks something like this:hINhWNhXhhCj/ubeubcsphinx.addnodes highlightlang rŠ)r‹}rŒ(hBUhCj hIhJhKU highlightlangrhM}rŽ(UlangXcabalUlinenothresholdI9223372036854775807 hR]hQ]hO]hP]hU]uhWMŚhXhhY]ubjš)r}r(hBXÖconstraints: HTTP ==4000.3.3, HTTP +warp-tests -warn-as-error -network23 +network-uri -mtl1 -conduit10, QuickCheck ==2.9.1, QuickCheck +templatehaskell, -- etc...hCj hIhJhKjhM}r‘(jŸj hR]hQ]hO]hP]hU]uhWMŻhXhhY]r’hbXÖ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•(hBUhCjubaubhu)r–}r—(hBX>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.hCj hIhJhKhyhM}r˜(hO]hP]hQ]hR]hU]uhWMähXhhY]r™(hbXDFor end-user executables, it is recommended that you distribute the rš…r›}rœ(hBXDFor end-user executables, it is recommended that you distribute the hINhWNhXhhCj–ubh›)r}rž(hBX``cabal.project.freeze``hM}rŸ(hO]hP]hQ]hR]hU]uhCj–hY]r hbXcabal.project.freezer”…r¢}r£(hBUhCjubahKh£ubhbXā 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¦(hBXā 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.hINhWNhXhhCj–ubeubeubhD)r§}rØ(hBUhCjšhIhJhKhLhM}r©(hO]hP]hQ]hR]rŖUcabal-new-benchr«ahU]r¬hauhWMėhXhhY]r­(h[)r®}rÆ(hBXcabal new-benchr°hCj§hIhJhKh_hM}r±(hO]hP]hQ]hR]hU]uhWMėhXhhY]r²hbXcabal new-benchr³…r“}rµ(hBj°hINhWNhXhhCj®ubaubhu)r¶}r·(hBX”``cabal new-bench [TARGETS] [OPTIONS]`` runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.hCj§hIhJhKhyhM}rø(hO]hP]hQ]hR]hU]uhWMķhXhhY]r¹(h›)rŗ}r»(hBX'``cabal new-bench [TARGETS] [OPTIONS]``hM}r¼(hO]hP]hQ]hR]hU]uhCj¶hY]r½hbX#cabal new-bench [TARGETS] [OPTIONS]r¾…ræ}rĄ(hBUhCjŗubahKh£ubhbXz runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.rĮ…rĀ}rĆ(hBXz runs the specified benchmarks (all the benchmarks in the current package by default), first ensuring they are up to date.hINhWNhXhhCj¶ubeubeubhD)rÄ}rÅ(hBUhCjšhIhJhKhLhM}rĘ(hO]hP]hQ]hR]rĒUcabal-new-testrČahU]rÉh7auhWMņhXhhY]rŹ(h[)rĖ}rĢ(hBXcabal new-testrĶhCjÄhIhJhKh_hM}rĪ(hO]hP]hQ]hR]hU]uhWMņhXhhY]rĻhbXcabal new-testrŠ…rŃ}rŅ(hBjĶhINhWNhXhhCjĖubaubhu)rÓ}rŌ(hBX¢``cabal new-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.hCjÄhIhJhKhyhM}rÕ(hO]hP]hQ]hR]hU]uhWMōhXhhY]rÖ(h›)r×}rŲ(hBX&``cabal new-test [TARGETS] [OPTIONS]``hM}rŁ(hO]hP]hQ]hR]hU]uhCjÓhY]rŚhbX"cabal new-test [TARGETS] [OPTIONS]rŪ…rÜ}rŻ(hBUhCj×ubahKh£ubhbX| runs the specified test suites (all the test suites in the current package by default), first ensuring they are up to date.rŽ…rß}rą(hBX| runs the specified test suites (all the test suites in the current package by default), first ensuring they are up to date.hINhWNhXhhCjÓubeubeubhD)rį}rā(hBUhCjšhIhJhKhLhM}rć(hO]hP]hQ]hR]räUcabal-new-haddockråahU]ręhauhWMłhXhhY]rē(h[)rč}ré(hBXcabal new-haddockrźhCjįhIhJhKh_hM}rė(hO]hP]hQ]hR]hU]uhWMłhXhhY]rģhbXcabal new-haddockrķ…rī}rļ(hBjźhINhWNhXhhCjčubaubhu)rš}rń(hBXr``cabal new-haddock [FLAGS] [TARGET]`` builds Haddock documentation for the specified packages within the project.hCjįhIhJhKhyhM}rņ(hO]hP]hQ]hR]hU]uhWMūhXhhY]ró(h›)rō}rõ(hBX&``cabal new-haddock [FLAGS] [TARGET]``hM}rö(hO]hP]hQ]hR]hU]uhCjšhY]r÷hbX"cabal new-haddock [FLAGS] [TARGET]rų…rł}rś(hBUhCjōubahKh£ubhbXL builds Haddock documentation for the specified packages within the project.rū…rü}rż(hBXL builds Haddock documentation for the specified packages within the project.hINhWNhXhhCjšubeubhu)rž}r’(hBX·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.hCjįhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMžhXhhY]r(hbXIf a target is not a library r…r}r(hBXIf a target is not a library hINhWNhXhhCjžubj[)r}r(hBX:cfg-field:`haddock-benchmarks`rhCjžhIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbXhaddock-benchmarksU refdomainXcabalr hR]hQ]U refexplicit‰hO]hP]hU]jdjeUcabal:cfg-sectionr NuhWMžhY]r h›)r }r (hBjhM}r(hO]hP]r(jlj Xcabal-cfg-fieldrehQ]hR]hU]uhCjhY]rhbXhaddock-benchmarksr…r}r(hBUhCj ubahKh£ubaubhbX, r…r}r(hBX, rhINhWNhXhhCjžubj[)r}r(hBX :cfg-field:`haddock-executables`rhCjžhIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbXhaddock-executablesU refdomainXcabalrhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMžhY]rh›)r}r (hBjhM}r!(hO]hP]r"(jljXcabal-cfg-fieldr#ehQ]hR]hU]uhCjhY]r$hbXhaddock-executablesr%…r&}r'(hBUhCjubahKh£ubaubhbX, r(…r)}r*(hBX, hINhWNhXhhCjžubj[)r+}r,(hBX:cfg-field:`haddock-internal`r-hCjžhIhJhKj_hM}r.(UreftypeX cfg-fieldjaˆjbXhaddock-internalU refdomainXcabalr/hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMžhY]r0h›)r1}r2(hBj-hM}r3(hO]hP]r4(jlj/Xcabal-cfg-fieldr5ehQ]hR]hU]uhCj+hY]r6hbXhaddock-internalr7…r8}r9(hBUhCj1ubahKh£ubaubhbX, r:…r;}r<(hBjhCjžubj[)r=}r>(hBX:cfg-field:`haddock-tests`r?hCjžhIhJhKj_hM}r@(UreftypeX cfg-fieldjaˆjbX haddock-testsU refdomainXcabalrAhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMžhY]rBh›)rC}rD(hBj?hM}rE(hO]hP]rF(jljAXcabal-cfg-fieldrGehQ]hR]hU]uhCj=hY]rHhbX haddock-testsrI…rJ}rK(hBUhCjCubahKh£ubaubhbX will be implied as necessary.rL…rM}rN(hBX will be implied as necessary.hINhWNhXhhCjžubeubeubhD)rO}rP(hBUhCjšhIhJhKhLhM}rQ(hO]hP]hQ]hR]rRUcabal-new-execrSahU]rTh+auhWMhXhhY]rU(h[)rV}rW(hBXcabal new-execrXhCjOhIhJhKh_hM}rY(hO]hP]hQ]hR]hU]uhWMhXhhY]rZhbXcabal new-execr[…r\}r](hBjXhINhWNhXhhCjVubaubhu)r^}r_(hBXŪ``cabal new-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.hCjOhIhJhKhyhM}r`(hO]hP]hQ]hR]hU]uhWMhXhhY]ra(h›)rb}rc(hBX3``cabal new-exec [FLAGS] [--] COMMAND [--] [ARGS]``hM}rd(hO]hP]hQ]hR]hU]uhCj^hY]rehbX/cabal new-exec [FLAGS] [--] COMMAND [--] [ARGS]rf…rg}rh(hBUhCjbubahKh£ubhbX¬ 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.ri…rj}rk(hBXØ 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.hINhWNhXhhCj^ubeubeubhD)rl}rm(hBUhCjšhIhJhKhLhM}rn(hO]hP]hQ]hR]roUcabal-new-installrpahU]rqhauhWM hXhhY]rr(h[)rs}rt(hBXcabal new-installruhCjlhIhJhKh_hM}rv(hO]hP]hQ]hR]hU]uhWM hXhhY]rwhbXcabal new-installrx…ry}rz(hBjuhINhWNhXhhCjsubaubhu)r{}r|(hBX•``cabal new-install [FLAGS] PACKAGES`` builds the specified packages and symlinks their executables in ``symlink-bindir`` (usually ``~/.cabal/bin``).hCjlhIhJhKhyhM}r}(hO]hP]hQ]hR]hU]uhWM hXhhY]r~(h›)r}r€(hBX&``cabal new-install [FLAGS] PACKAGES``hM}r(hO]hP]hQ]hR]hU]uhCj{hY]r‚hbX"cabal new-install [FLAGS] PACKAGESrƒ…r„}r…(hBUhCjubahKh£ubhbXA builds the specified packages and symlinks their executables in r†…r‡}rˆ(hBXA builds the specified packages and symlinks their executables in hINhWNhXhhCj{ubh›)r‰}rŠ(hBX``symlink-bindir``hM}r‹(hO]hP]hQ]hR]hU]uhCj{hY]rŒhbXsymlink-bindirr…rŽ}r(hBUhCj‰ubahKh£ubhbX (usually r…r‘}r’(hBX (usually hINhWNhXhhCj{ubh›)r“}r”(hBX``~/.cabal/bin``hM}r•(hO]hP]hQ]hR]hU]uhCj{hY]r–hbX ~/.cabal/binr—…r˜}r™(hBUhCj“ubahKh£ubhbX).rš…r›}rœ(hBX).hINhWNhXhhCj{ubeubhu)r}rž(hBXfFor example this command will build the latest ``cabal-install`` and symlink its ``cabal`` executable:hCjlhIhJhKhyhM}rŸ(hO]hP]hQ]hR]hU]uhWMhXhhY]r (hbX/For example this command will build the latest r”…r¢}r£(hBX/For example this command will build the latest hINhWNhXhhCjubh›)r¤}r„(hBX``cabal-install``hM}r¦(hO]hP]hQ]hR]hU]uhCjhY]r§hbX cabal-installrØ…r©}rŖ(hBUhCj¤ubahKh£ubhbX and symlink its r«…r¬}r­(hBX and symlink its hINhWNhXhhCjubh›)r®}rÆ(hBX ``cabal``hM}r°(hO]hP]hQ]hR]hU]uhCjhY]r±hbXcabalr²…r³}r“(hBUhCj®ubahKh£ubhbX executable:rµ…r¶}r·(hBX executable:hINhWNhXhhCjubeubjš)rø}r¹(hBX!$ cabal new-install cabal-installhCjlhIhJhKjhM}rŗ(jŸj hR]hQ]hO]hP]hU]uhWMhXhhY]r»hbX!$ cabal new-install cabal-installr¼…r½}r¾(hBUhCjøubaubhu)ræ}rĄ(hBXõIn addition, it's possible to use ``cabal new-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:hCjlhIhJhKhyhM}rĮ(hO]hP]hQ]hR]hU]uhWMhXhhY]rĀ(hbX$In addition, itā€™s possible to use rĆ…rÄ}rÅ(hBX"In addition, it's possible to use hINhWNhXhhCjæubh›)rĘ}rĒ(hBX``cabal new-install``hM}rČ(hO]hP]hQ]hR]hU]uhCjæhY]rÉhbXcabal new-installrŹ…rĖ}rĢ(hBUhCjĘubahKh£ubhbX© 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 rĶ…rĪ}rĻ(hBX© 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 hINhWNhXhhCjæubh›)rŠ}rŃ(hBX ``cabal``hM}rŅ(hO]hP]hQ]hR]hU]uhCjæhY]rÓhbXcabalrŌ…rÕ}rÖ(hBUhCjŠubahKh£ubhbX executable:r×…rŲ}rŁ(hBX executable:hINhWNhXhhCjæubeubjš)rŚ}rŪ(hBX$ cabal new-install exe:cabalhCjlhIhJhKjhM}rÜ(jŸj hR]hQ]hO]hP]hU]uhWMhXhhY]rŻhbX$ cabal new-install exe:cabalrŽ…rß}rą(hBUhCjŚubaubhu)rį}rā(hBX’It is also possible to "install" libraries using the ``--lib`` flag. For example, this command will build the latest Cabal library and install it:hCjlhIhJhKhyhM}rć(hO]hP]hQ]hR]hU]uhWMhXhhY]rä(hbX9It is also possible to ā€œinstallā€ libraries using the r允rę}rē(hBX5It is also possible to "install" libraries using the hINhWNhXhhCjįubh›)rč}ré(hBX ``--lib``hM}rź(hO]hP]hQ]hR]hU]uhCjįhY]rėhbX--librģ…rķ}rī(hBUhCjčubahKh£ubhbXT flag. For example, this command will build the latest Cabal library and install it:rļ…rš}rń(hBXT flag. For example, this command will build the latest Cabal library and install it:hINhWNhXhhCjįubeubjš)rņ}ró(hBX$ cabal new-install --lib CabalhCjlhIhJhKjhM}rō(jŸj hR]hQ]hO]hP]hU]uhWM$hXhhY]rõhbX$ cabal new-install --lib Cabalrö…r÷}rų(hBUhCjņubaubhu)rł}rś(hBXśThis works by managing GHC environments. By default, it is writing to the global environment in ``~/.ghc/$ARCH-$OS-$GHCVER/environments/default``. ``new-install`` provides the ``--package-env`` flag to control which of these environments is modified.hCjlhIhJhKhyhM}rū(hO]hP]hQ]hR]hU]uhWM&hXhhY]rü(hbX`This works by managing GHC environments. By default, it is writing to the global environment in rż…rž}r’(hBX`This works by managing GHC environments. By default, it is writing to the global environment in hINhWNhXhhCjłubh›)r }r (hBX1``~/.ghc/$ARCH-$OS-$GHCVER/environments/default``hM}r (hO]hP]hQ]hR]hU]uhCjłhY]r hbX-~/.ghc/$ARCH-$OS-$GHCVER/environments/defaultr …r }r (hBUhCj ubahKh£ubhbX. r …r }r (hBX. hINhWNhXhhCjłubh›)r }r (hBX``new-install``hM}r (hO]hP]hQ]hR]hU]uhCjłhY]r hbX new-installr …r }r (hBUhCj ubahKh£ubhbX provides the r …r }r (hBX provides the hINhWNhXhhCjłubh›)r }r (hBX``--package-env``hM}r (hO]hP]hQ]hR]hU]uhCjłhY]r hbX --package-envr …r }r (hBUhCj ubahKh£ubhbX9 flag to control which of these environments is modified.r …r }r (hBX9 flag to control which of these environments is modified.hINhWNhXhhCjłubeubhu)r }r (hBXGThis command will modify the environment file in the current directory:r hCjlhIhJhKhyhM}r! (hO]hP]hQ]hR]hU]uhWM+hXhhY]r" hbXGThis command will modify the environment file in the current directory:r# …r$ }r% (hBj hINhWNhXhhCj ubaubjš)r& }r' (hBX/$ cabal new-install --lib Cabal --package-env .hCjlhIhJhKjhM}r( (jŸj hR]hQ]hO]hP]hU]uhWM/hXhhY]r) hbX/$ cabal new-install --lib Cabal --package-env .r* …r+ }r, (hBUhCj& ubaubhu)r- }r. (hBXHThis command will modify the enviroment file in the ``~/foo`` directory:r/ hCjlhIhJhKhyhM}r0 (hO]hP]hQ]hR]hU]uhWM1hXhhY]r1 (hbX4This command will modify the enviroment file in the r2 …r3 }r4 (hBX4This command will modify the enviroment file in the hINhWNhXhhCj- ubh›)r5 }r6 (hBX ``~/foo``hM}r7 (hO]hP]hQ]hR]hU]uhCj- hY]r8 hbX~/foor9 …r: }r; (hBUhCj5 ubahKh£ubhbX directory:r< …r= }r> (hBX directory:hINhWNhXhhCj- ubeubjš)r? }r@ (hBX2$ cabal new-install --lib Cabal --package-env foo/hCjlhIhJhKjhM}rA (jŸj hR]hQ]hO]hP]hU]uhWM5hXhhY]rB hbX2$ cabal new-install --lib Cabal --package-env foo/rC …rD }rE (hBUhCj? ubaubhu)rF }rG (hBX²Do note that the results of the previous two commands will be overwritten by the use of other new-style commands, so it is not reccomended to use them inside a project directory.rH hCjlhIhJhKhyhM}rI (hO]hP]hQ]hR]hU]uhWM7hXhhY]rJ hbX²Do note that the results of the previous two commands will be overwritten by the use of other new-style commands, so it is not reccomended to use them inside a project directory.rK …rL }rM (hBjH hINhWNhXhhCjF ubaubhu)rN }rO (hBXZThis command will modify the environment in the "local.env" file in the current directory:rP hCjlhIhJhKhyhM}rQ (hO]hP]hQ]hR]hU]uhWM;hXhhY]rR hbX^This command will modify the environment in the ā€œlocal.envā€ file in the current directory:rS …rT }rU (hBjP hINhWNhXhhCjN ubaubjš)rV }rW (hBX7$ cabal new-install --lib Cabal --package-env local.envhCjlhIhJhKjhM}rX (jŸj hR]hQ]hO]hP]hU]uhWM@hXhhY]rY hbX7$ cabal new-install --lib Cabal --package-env local.envrZ …r[ }r\ (hBUhCjV ubaubhu)r] }r^ (hBX@This command will modify the ``myenv`` named global environment:r_ hCjlhIhJhKhyhM}r` (hO]hP]hQ]hR]hU]uhWMBhXhhY]ra (hbXThis command will modify the rb …rc }rd (hBXThis command will modify the hINhWNhXhhCj] ubh›)re }rf (hBX ``myenv``hM}rg (hO]hP]hQ]hR]hU]uhCj] hY]rh hbXmyenvri …rj }rk (hBUhCje ubahKh£ubhbX named global environment:rl …rm }rn (hBX named global environment:hINhWNhXhhCj] ubeubjš)ro }rp (hBX3$ cabal new-install --lib Cabal --package-env myenvhCjlhIhJhKjhM}rq (jŸj hR]hQ]hO]hP]hU]uhWMFhXhhY]rr hbX3$ cabal new-install --lib Cabal --package-env myenvrs …rt }ru (hBUhCjo ubaubhu)rv }rw (hBX›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``.hCjlhIhJhKhyhM}rx (hO]hP]hQ]hR]hU]uhWMHhXhhY]ry (hbX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 rz …r{ }r| (hBX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 hINhWNhXhhCjv ubh›)r} }r~ (hBX ``./myenv``hM}r (hO]hP]hQ]hR]hU]uhCjv hY]r€ hbX./myenvr …r‚ }rƒ (hBUhCj} ubahKh£ubhbX.…r„ }r… (hBX.hINhWNhXhhCjv ubeubhu)r† }r‡ (hBXĮYou can learn more about how to use these environments in `this section of the GHC manual `_.hCjlhIhJhKhyhM}rˆ (hO]hP]hQ]hR]hU]uhWMKhXhhY]r‰ (hbX:You can learn more about how to use these environments in rŠ …r‹ }rŒ (hBX:You can learn more about how to use these environments in hINhWNhXhhCj† ubji)r }rŽ (hBX†`this section of the GHC manual `_hM}r (UnameXthis section of the GHC manualjmXbhttps://downloads.haskell.org/~ghc/latest/docs/html/users_guide/packages.html#package-environmentsr hR]hQ]hO]hP]hU]uhCj† hY]r‘ hbXthis section of the GHC manualr’ …r“ }r” (hBUhCj ubahKjrubj€)r• }r– (hBXe U referencedr— KhCj† hKj†hM}r˜ (Urefurij hR]r™ Uthis-section-of-the-ghc-manualrš ahQ]hO]hP]hU]r› h)auhY]ubhbX.…rœ }r (hBX.hINhWNhXhhCj† ubeubeubhD)rž }rŸ (hBUhCjšhIhJhKhLhM}r  (hO]hP]hQ]hR]r” Ucabal-new-cleanr¢ ahU]r£ h3auhWMOhXhhY]r¤ (h[)r„ }r¦ (hBXcabal new-cleanr§ hCjž hIhJhKh_hM}rØ (hO]hP]hQ]hR]hU]uhWMOhXhhY]r© hbXcabal new-cleanrŖ …r« }r¬ (hBj§ hINhWNhXhhCj„ ubaubhu)r­ }r® (hBXu``cabal new-clean [FLAGS]`` cleans up the temporary files and build artifacts stored in the ``dist-newstyle`` folder.hCjž hIhJhKhyhM}rÆ (hO]hP]hQ]hR]hU]uhWMQhXhhY]r° (h›)r± }r² (hBX``cabal new-clean [FLAGS]``hM}r³ (hO]hP]hQ]hR]hU]uhCj­ hY]r“ hbXcabal new-clean [FLAGS]rµ …r¶ }r· (hBUhCj± ubahKh£ubhbXA cleans up the temporary files and build artifacts stored in the rø …r¹ }rŗ (hBXA cleans up the temporary files and build artifacts stored in the hINhWNhXhhCj­ ubh›)r» }r¼ (hBX``dist-newstyle``hM}r½ (hO]hP]hQ]hR]hU]uhCj­ hY]r¾ hbX dist-newstyleræ …rĄ }rĮ (hBUhCj» ubahKh£ubhbX folder.rĀ …rĆ }rÄ (hBX folder.hINhWNhXhhCj­ ubeubhu)rÅ }rĘ (hBX'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).hCjž hIhJhKhyhM}rĒ (hO]hP]hQ]hR]hU]uhWMThXhhY]rČ (hbXdBy default, it removes the entire folder, but it can also spare the configuration and caches if the rÉ …rŹ }rĖ (hBXdBy default, it removes the entire folder, but it can also spare the configuration and caches if the hINhWNhXhhCjÅ ubh›)rĢ }rĶ (hBX``--save-config``hM}rĪ (hO]hP]hQ]hR]hU]uhCjÅ hY]rĻ hbX --save-configrŠ …rŃ }rŅ (hBUhCjĢ ubahKh£ubhbXE option is given, in which case it only removes the build artefacts (rÓ …rŌ }rÕ (hBXE option is given, in which case it only removes the build artefacts (hINhWNhXhhCjÅ ubh›)rÖ }r× (hBX``.hi``hM}rŲ (hO]hP]hQ]hR]hU]uhCjÅ hY]rŁ hbX.hirŚ …rŪ }rÜ (hBUhCjÖ ubahKh£ubhbX, rŻ …rŽ }rß (hBX, hINhWNhXhhCjÅ ubh›)rą }rį (hBX``.o``hM}rā (hO]hP]hQ]hR]hU]uhCjÅ hY]rć hbX.orä …rå }rę (hBUhCją ubahKh£ubhbX^ along with any other temporary files generated by the compiler, along with the build output).rē …rč }ré (hBX^ along with any other temporary files generated by the compiler, along with the build output).hINhWNhXhhCjÅ ubeubeubhD)rź }rė (hBUhCjšhIhJhKhLhM}rģ (hO]hP]hQ]hR]rķ Ucabal-new-sdistrī ahU]rļ h,auhWMZhXhhY]rš (h[)rń }rņ (hBXcabal new-sdistró hCjź hIhJhKh_hM}rō (hO]hP]hQ]hR]hU]uhWMZhXhhY]rõ hbXcabal new-sdiströ …r÷ }rų (hBjó hINhWNhXhhCjń ubaubhu)rł }rś (hBX``cabal new-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.hCjź hIhJhKhyhM}rū (hO]hP]hQ]hR]hU]uhWM\hXhhY]rü (h›)rż }rž (hBX%``cabal new-sdist [FLAGS] [TARGETS]``hM}r’ (hO]hP]hQ]hR]hU]uhCjł hY]r hbX!cabal new-sdist [FLAGS] [TARGETS]r …r }r (hBUhCjż ubahKh£ubhbX) takes the crucial files needed to build r …r }r (hBX) takes the crucial files needed to build hINhWNhXhhCjł ubh›)r }r (hBX ``TARGETS``hM}r (hO]hP]hQ]hR]hU]uhCjł hY]r hbXTARGETSr …r }r (hBUhCj ubahKh£ubhbXø 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 (hBXø 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.hINhWNhXhhCjł ubeubhu)r }r (hBX.``cabal new-sdist`` takes the following flags:r hCjź hIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWM`hXhhY]r (h›)r }r (hBX``cabal new-sdist``hM}r (hO]hP]hQ]hR]hU]uhCj hY]r hbXcabal new-sdistr …r }r (hBUhCj ubahKh£ubhbX takes the following flags:r …r }r (hBX takes the following flags:hINhWNhXhhCj ubeubh‡)r }r! (hBUhCjź hIhJhKhŠhM}r" (hŒX-hR]hQ]hO]hP]hU]uhWMbhXhhY]r# (hŽ)r$ }r% (hBXæ``-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. hCj hIhJhKh‘hM}r& (hO]hP]hQ]hR]hU]uhWNhXhhY]r' hu)r( }r) (hBX¾``-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.hCj$ hIhJhKhyhM}r* (hO]hP]hQ]hR]hU]uhWMbhY]r+ (h›)r, }r- (hBX``-l``hM}r. (hO]hP]hQ]hR]hU]uhCj( hY]r/ hbX-lr0 …r1 }r2 (hBUhCj, ubahKh£ubhbX, r3 …r4 }r5 (hBX, hCj( ubh›)r6 }r7 (hBX``--list-only``hM}r8 (hO]hP]hQ]hR]hU]uhCj( hY]r9 hbX --list-onlyr: …r; }r< (hBUhCj6 ubahKh£ubhbXT: Rather than creating an archive, lists files that would be included. Output is to r= …r> }r? (hBXT: Rather than creating an archive, lists files that would be included. Output is to hCj( ubh›)r@ }rA (hBX ``stdout``hM}rB (hO]hP]hQ]hR]hU]uhCj( hY]rC hbXstdoutrD …rE }rF (hBUhCj@ ubahKh£ubhbXK by default. The file paths are relative to the projectā€™s root directory.rG …rH }rI (hBXI by default. The file paths are relative to the project's root directory.hCj( ubeubaubhŽ)rJ }rK (hBX6``--targz``: Output an archive in ``.tar.gz`` format. hCj hIhJhKh‘hM}rL (hO]hP]hQ]hR]hU]uhWNhXhhY]rM hu)rN }rO (hBX5``--targz``: Output an archive in ``.tar.gz`` format.hCjJ hIhJhKhyhM}rP (hO]hP]hQ]hR]hU]uhWMfhY]rQ (h›)rR }rS (hBX ``--targz``hM}rT (hO]hP]hQ]hR]hU]uhCjN hY]rU hbX--targzrV …rW }rX (hBUhCjR ubahKh£ubhbX: Output an archive in rY …rZ }r[ (hBX: Output an archive in hCjN ubh›)r\ }r] (hBX ``.tar.gz``hM}r^ (hO]hP]hQ]hR]hU]uhCjN hY]r_ hbX.tar.gzr` …ra }rb (hBUhCj\ ubahKh£ubhbX format.rc …rd }re (hBX format.hCjN ubeubaubhŽ)rf }rg (hBX1``--zip``: Output an archive in ``.zip`` format. hCj hIhJhKh‘hM}rh (hO]hP]hQ]hR]hU]uhWNhXhhY]ri hu)rj }rk (hBX0``--zip``: Output an archive in ``.zip`` format.hCjf hIhJhKhyhM}rl (hO]hP]hQ]hR]hU]uhWMhhY]rm (h›)rn }ro (hBX ``--zip``hM}rp (hO]hP]hQ]hR]hU]uhCjj hY]rq hbX--ziprr …rs }rt (hBUhCjn ubahKh£ubhbX: Output an archive in ru …rv }rw (hBX: Output an archive in hCjj ubh›)rx }ry (hBX``.zip``hM}rz (hO]hP]hQ]hR]hU]uhCjj hY]r{ hbX.zipr| …r} }r~ (hBUhCjx ubahKh£ubhbX format.r …r€ }r (hBX format.hCjj ubeubaubhŽ)r‚ }rƒ (hBX×``-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. hCj hIhJhKh‘hM}r„ (hO]hP]hQ]hR]hU]uhWNhXhhY]r… hu)r† }r‡ (hBXÖ``-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.hCj‚ hIhJhKhyhM}rˆ (hO]hP]hQ]hR]hU]uhWMjhY]r‰ (h›)rŠ }r‹ (hBX``-o``hM}rŒ (hO]hP]hQ]hR]hU]uhCj† hY]r hbX-orŽ …r }r (hBUhCjŠ ubahKh£ubhbX, r‘ …r’ }r“ (hBX, hCj† ubh›)r” }r• (hBX``--output-dir``hM}r– (hO]hP]hQ]hR]hU]uhCj† hY]r— hbX --output-dirr˜ …r™ }rš (hBUhCj” ubahKh£ubhbXG: Sets the output dir, if a non-default one is desired. The default is r› …rœ }r (hBXG: Sets the output dir, if a non-default one is desired. The default is hCj† ubh›)rž }rŸ (hBX``dist-newstyle/sdist/``hM}r  (hO]hP]hQ]hR]hU]uhCj† hY]r” hbXdist-newstyle/sdist/r¢ …r£ }r¤ (hBUhCjž ubahKh£ubhbX. r„ …r¦ }r§ (hBX. hCj† ubh›)rØ }r© (hBX``--output-dir -``hM}rŖ (hO]hP]hQ]hR]hU]uhCj† hY]r« hbX--output-dir -r¬ …r­ }r® (hBUhCjØ ubahKh£ubhbX will send output to rÆ …r° }r± (hBX will send output to hCj† ubh›)r² }r³ (hBX ``stdout``hM}r“ (hO]hP]hQ]hR]hU]uhCj† hY]rµ hbXstdoutr¶ …r· }rø (hBUhCj² ubahKh£ubhbX, unless multiple archives are being created.r¹ …rŗ }r» (hBX, unless multiple archives are being created.hCj† ubeubaubhŽ)r¼ }r½ (hBXm``-z``, ``--null``: Only used with ``--list-only``. Separates filenames with a NUL byte instead of newlines. hCj hIhJhKh‘hM}r¾ (hO]hP]hQ]hR]hU]uhWNhXhhY]ræ hu)rĄ }rĮ (hBXl``-z``, ``--null``: Only used with ``--list-only``. Separates filenames with a NUL byte instead of newlines.hCj¼ hIhJhKhyhM}rĀ (hO]hP]hQ]hR]hU]uhWMnhY]rĆ (h›)rÄ }rÅ (hBX``-z``hM}rĘ (hO]hP]hQ]hR]hU]uhCjĄ hY]rĒ hbX-zrČ …rÉ }rŹ (hBUhCjÄ ubahKh£ubhbX, rĖ …rĢ }rĶ (hBX, hCjĄ ubh›)rĪ }rĻ (hBX ``--null``hM}rŠ (hO]hP]hQ]hR]hU]uhCjĄ hY]rŃ hbX--nullrŅ …rÓ }rŌ (hBUhCjĪ ubahKh£ubhbX: Only used with rÕ …rÖ }r× (hBX: Only used with hCjĄ ubh›)rŲ }rŁ (hBX``--list-only``hM}rŚ (hO]hP]hQ]hR]hU]uhCjĄ hY]rŪ hbX --list-onlyrÜ …rŻ }rŽ (hBUhCjŲ ubahKh£ubhbX:. Separates filenames with a NUL byte instead of newlines.rß …rą }rį (hBX:. Separates filenames with a NUL byte instead of newlines.hCjĄ ubeubaubeubhu)rā }rć (hBXÆ``new-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 new-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.hCjź hIhJhKhyhM}rä (hO]hP]hQ]hR]hU]uhWMqhXhhY]rå (h›)rę }rē (hBX ``new-sdist``hM}rč (hO]hP]hQ]hR]hU]uhCjā hY]ré hbX new-sdistrź …rė }rģ (hBUhCję ubahKh£ubhbX  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 new-build ecosystem. rķ …rī }rļ (hBX  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 new-build ecosystem. hINhWNhXhhCjā ubh›)rš }rń (hBX``autogen-modules``hM}rņ (hO]hP]hQ]hR]hU]uhCjā hY]ró hbXautogen-modulesrō …rõ }rö (hBUhCjš ubahKh£ubhbX… is able to replace uses of the hooks to add generated modules, along with the custom publishing of Haddock documentation to Hackage.r÷ …rų }rł (hBX… is able to replace uses of the hooks to add generated modules, along with the custom publishing of Haddock documentation to Hackage.hINhWNhXhhCjā ubeubeubeubhIhJhKhLhM}rś (hO]hP]hQ]hR]rū Ucabal-new-buildrü ahU]rż h5auhWM?hXhhY]rž (h[)r’ }r (hBXcabal new-buildr hCjīhIhJhKh_hM}r (hO]hP]hQ]hR]hU]uhWM?hXhhY]r hbXcabal new-buildr …r }r (hBj hINhWNhXhhCj’ ubaubhu)r }r (hBX``cabal new-build`` takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.hCjīhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMAhXhhY]r (h›)r }r (hBX``cabal new-build``hM}r (hO]hP]hQ]hR]hU]uhCj hY]r hbXcabal new-buildr …r }r (hBUhCj ubahKh£ubhbX| takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.r …r }r (hBX| takes a set of targets and builds them. It automatically handles building and installing any dependencies of these targets.hINhWNhXhhCj ubeubhu)r }r (hBX-A target can take any of the following forms:r hCjīhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMEhXhhY]r hbX-A target can take any of the following forms:r …r }r (hBj hINhWNhXhhCj ubaubjģhu)r }r (hBXØ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.hCjīhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWM[hXhhY]r (hbXIn component targets, r! …r" }r# (hBXIn component targets, hINhWNhXhhCj ubh›)r$ }r% (hBX ``package:``hM}r& (hO]hP]hQ]hR]hU]uhCj hY]r' hbXpackage:r( …r) }r* (hBUhCj$ ubahKh£ubhbX and r+ …r, }r- (hBX and r. hINhWNhXhhCj ubh›)r/ }r0 (hBX ``ctype:``hM}r1 (hO]hP]hQ]hR]hU]uhCj hY]r2 hbXctype:r3 …r4 }r5 (hBUhCj/ ubahKh£ubhbX (valid component types are r6 …r7 }r8 (hBX (valid component types are hINhWNhXhhCj ubh›)r9 }r: (hBX``lib``hM}r; (hO]hP]hQ]hR]hU]uhCj hY]r< hbXlibr= …r> }r? (hBUhCj9 ubahKh£ubhbX, r@ …rA }rB (hBX, rC hINhWNhXhhCj ubh›)rD }rE (hBX``flib``hM}rF (hO]hP]hQ]hR]hU]uhCj hY]rG hbXflibrH …rI }rJ (hBUhCjD ubahKh£ubhbX, rK …rL }rM (hBX, hCj ubh›)rN }rO (hBX``exe``hM}rP (hO]hP]hQ]hR]hU]uhCj hY]rQ hbXexerR …rS }rT (hBUhCjN ubahKh£ubhbX, rU …rV }rW (hBjC hCj ubh›)rX }rY (hBX``test``hM}rZ (hO]hP]hQ]hR]hU]uhCj hY]r[ hbXtestr\ …r] }r^ (hBUhCjX ubahKh£ubhbX and r_ …r` }ra (hBj. hCj ubh›)rb }rc (hBX ``bench``hM}rd (hO]hP]hQ]hR]hU]uhCj hY]re hbXbenchrf …rg }rh (hBUhCjb ubahKh£ubhbX‘) 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 ri …rj }rk (hBX‘) 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 hINhWNhXhhCj ubh›)rl }rm (hBX``foo``hM}rn (hO]hP]hQ]hR]hU]uhCj hY]ro hbXfoorp …rq }rr (hBUhCjl ubahKh£ubhbX. defines both an executable and library named rs …rt }ru (hBX. defines both an executable and library named hINhWNhXhhCj ubh›)rv }rw (hBX``foo``hM}rx (hO]hP]hQ]hR]hU]uhCj hY]ry hbXfoorz …r{ }r| (hBUhCjv ubahKh£ubhbX\). We always prefer interpreting a target as a package name rather than as a component name.r} …r~ }r (hBX\). We always prefer interpreting a target as a package name rather than as a component name.hINhWNhXhhCj ubeubhu)r€ }r (hBXSome example targets:r‚ hCjīhIhJhKhyhM}rƒ (hO]hP]hQ]hR]hU]uhWMbhXhhY]r„ hbXSome example targets:r… …r† }r‡ (hBj‚ hINhWNhXhhCj€ ubaubjš)rˆ }r‰ (hBX†$ cabal new-build lib:foo-pkg # build the library named foo-pkg $ cabal new-build foo-pkg:foo-tests # build foo-tests in foo-pkghCjīhIhJhKjhM}rŠ (jŸj hR]hQ]hO]hP]hU]uhWMfhXhhY]r‹ hbX†$ cabal new-build lib:foo-pkg # build the library named foo-pkg $ cabal new-build foo-pkg:foo-tests # build foo-tests in foo-pkgrŒ …r }rŽ (hBUhCjˆ ubaubhu)r }r (hBXd(There is also syntax for specifying module and file targets, but it doesn't currently do anything.)r‘ hCjīhIhJhKhyhM}r’ (hO]hP]hQ]hR]hU]uhWMihXhhY]r“ hbXf(There is also syntax for specifying module and file targets, but it doesnā€™t currently do anything.)r” …r• }r– (hBj‘ hINhWNhXhhCj ubaubhu)r— }r˜ (hBXŠBeyond a list of targets, ``cabal new-build`` accepts all the flags that ``cabal new-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.)hCjīhIhJhKhyhM}r™ (hO]hP]hQ]hR]hU]uhWMlhXhhY]rš (hbXBeyond a list of targets, r› …rœ }r (hBXBeyond a list of targets, hINhWNhXhhCj— ubh›)rž }rŸ (hBX``cabal new-build``hM}r  (hO]hP]hQ]hR]hU]uhCj— hY]r” hbXcabal new-buildr¢ …r£ }r¤ (hBUhCjž ubahKh£ubhbX accepts all the flags that r„ …r¦ }r§ (hBX accepts all the flags that hINhWNhXhhCj— ubh›)rØ }r© (hBX``cabal new-configure``hM}rŖ (hO]hP]hQ]hR]hU]uhCj— hY]r« hbXcabal new-configurer¬ …r­ }r® (hBUhCjØ ubahKh£ubhbX© 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± (hBX© 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, hINhWNhXhhCj— ubh›)r² }r³ (hBX``--enable-profiling``hM}r“ (hO]hP]hQ]hR]hU]uhCj— hY]rµ hbX--enable-profilingr¶ …r· }rø (hBUhCj² ubahKh£ubhbXk will automatically make sure profiling libraries for all transitive dependencies are built and installed.)r¹ …rŗ }r» (hBXk will automatically make sure profiling libraries for all transitive dependencies are built and installed.)hINhWNhXhhCj— ubeubeubhIhJhKhŠhM}r¼ (hŒX-hR]hQ]hO]hP]hU]uhWMGhXhhY]r½ (hŽ)r¾ }ræ (hBXä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``.) hCjģhIhJhKh‘hM}rĄ (hO]hP]hQ]hR]hU]uhWNhXhhY]rĮ hu)rĀ }rĆ (hBXć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``.)hCj¾ hIhJhKhyhM}rÄ (hO]hP]hQ]hR]hU]uhWMGhY]rÅ (hbXA package target: rĘ …rĒ }rČ (hBXA package target: hCjĀ ubh›)rÉ }rŹ (hBX ``package``hM}rĖ (hO]hP]hQ]hR]hU]uhCjĀ hY]rĢ hbXpackagerĶ …rĪ }rĻ (hBUhCjÉ ubahKh£ubhbXs, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are rŠ …rŃ }rŅ (hBXs, which specifies that all enabled components of a package to be built. By default, test suites and benchmarks are hCjĀ ubjŖ)rÓ }rŌ (hBX*not*hM}rÕ (hO]hP]hQ]hR]hU]uhCjĀ hY]rÖ hbXnotr× …rŲ }rŁ (hBUhCjÓ ubahKj²ubhbX: enabled, unless they are explicitly requested (e.g., via rŚ …rŪ }rÜ (hBX: enabled, unless they are explicitly requested (e.g., via hCjĀ ubh›)rŻ }rŽ (hBX``--enable-tests``hM}rß (hO]hP]hQ]hR]hU]uhCjĀ hY]rą hbX--enable-testsrį …rā }rć (hBUhCjŻ ubahKh£ubhbX.)rä …rå }rę (hBX.)hCjĀ ubeubaubhŽ)rē }rč (hBXžA component target: ``[package:][ctype:]component``, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built. hCjģhIhJhKh‘hM}ré (hO]hP]hQ]hR]hU]uhWNhXhhY]rź hu)rė }rģ (hBXA component target: ``[package:][ctype:]component``, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.hCjē hIhJhKhyhM}rķ (hO]hP]hQ]hR]hU]uhWMLhY]rī (hbXA component target: rļ …rš }rń (hBXA component target: hCjė ubh›)rņ }ró (hBX``[package:][ctype:]component``hM}rō (hO]hP]hQ]hR]hU]uhCjė hY]rõ hbXackage:][ctype:]componentrö …r÷ }rų (hBUhCjņ ubahKh£ubhbXj, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.rł …rś }rū (hBXj, which specifies a specific component (e.g., a library, executable, test suite or benchmark) to be built.hCjė ubeubaubhŽ)rü }rż (hBXHAll packages: ``all``, which specifies all packages within the project. hCjģhIhJhKh‘hM}rž (hO]hP]hQ]hR]hU]uhWNhXhhY]r’ hu)r }r (hBXGAll packages: ``all``, which specifies all packages within the project.hCjü hIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMPhY]r (hbXAll packages: r …r }r (hBXAll packages: hCj ubh›)r }r (hBX``all``hM}r (hO]hP]hQ]hR]hU]uhCj hY]r hbXallr …r }r (hBUhCj ubahKh£ubhbX2, which specifies all packages within the project.r …r }r (hBX2, which specifies all packages within the project.hCj ubeubaubjźeubhIhJhKh‘hM}r (hO]hP]hQ]hR]hU]uhWNhXhhY]r (hu)r }r (hBX’Components of a particular type: ``package:ctypes``, ``all:ctypes``: which specifies all components of the given type. Where valid ``ctypes`` are:hCjźhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMRhY]r (hbX!Components of a particular type: r …r }r (hBX!Components of a particular type: hCj ubh›)r }r (hBX``package:ctypes``hM}r (hO]hP]hQ]hR]hU]uhCj hY]r hbXpackage:ctypesr …r }r (hBUhCj ubahKh£ubhbX, r! …r" }r# (hBX, hCj ubh›)r$ }r% (hBX``all:ctypes``hM}r& (hO]hP]hQ]hR]hU]uhCj hY]r' hbX all:ctypesr( …r) }r* (hBUhCj$ ubahKh£ubhbX@: which specifies all components of the given type. Where valid r+ …r, }r- (hBX@: which specifies all components of the given type. Where valid hCj ubh›)r. }r/ (hBX ``ctypes``hM}r0 (hO]hP]hQ]hR]hU]uhCj hY]r1 hbXctypesr2 …r3 }r4 (hBUhCj. ubahKh£ubhbX are:r5 …r6 }r7 (hBX are:hCj ubeubcdocutils.nodes block_quote r8 )r9 }r: (hBUhM}r; (hO]hP]hQ]hR]hU]uhCjźhY]r< h‡)r= }r> (hBUhCj9 hIhJhKhŠhM}r? (hŒX-hR]hQ]hO]hP]hU]uhWMUhY]r@ (hŽ)rA }rB (hBX``libs``, ``libraries``,rC hM}rD (hO]hP]hQ]hR]hU]uhCj= hY]rE hu)rF }rG (hBjC hCjA hIhJhKhyhM}rH (hO]hP]hQ]hR]hU]uhWMUhY]rI (h›)rJ }rK (hBX``libs``hM}rL (hO]hP]hQ]hR]hU]uhCjF hY]rM hbXlibsrN …rO }rP (hBUhCjJ ubahKh£ubhbX, rQ …rR }rS (hBX, hCjF ubh›)rT }rU (hBX ``libraries``hM}rV (hO]hP]hQ]hR]hU]uhCjF hY]rW hbX librariesrX …rY }rZ (hBUhCjT ubahKh£ubhbX,…r[ }r\ (hBX,hCjF ubeubahKh‘ubhŽ)r] }r^ (hBX!``flibs``, ``foreign-libraries``,r_ hM}r` (hO]hP]hQ]hR]hU]uhCj= hY]ra hu)rb }rc (hBj_ hCj] hIhJhKhyhM}rd (hO]hP]hQ]hR]hU]uhWMVhY]re (h›)rf }rg (hBX ``flibs``hM}rh (hO]hP]hQ]hR]hU]uhCjb hY]ri hbXflibsrj …rk }rl (hBUhCjf ubahKh£ubhbX, rm …rn }ro (hBX, hCjb ubh›)rp }rq (hBX``foreign-libraries``hM}rr (hO]hP]hQ]hR]hU]uhCjb hY]rs hbXforeign-librariesrt …ru }rv (hBUhCjp ubahKh£ubhbX,…rw }rx (hBX,hCjb ubeubahKh‘ubhŽ)ry }rz (hBX``exes``, ``executables``,r{ hM}r| (hO]hP]hQ]hR]hU]uhCj= hY]r} hu)r~ }r (hBj{ hCjy hIhJhKhyhM}r€ (hO]hP]hQ]hR]hU]uhWMWhY]r (h›)r‚ }rƒ (hBX``exes``hM}r„ (hO]hP]hQ]hR]hU]uhCj~ hY]r… hbXexesr† …r‡ }rˆ (hBUhCj‚ ubahKh£ubhbX, r‰ …rŠ }r‹ (hBX, hCj~ ubh›)rŒ }r (hBX``executables``hM}rŽ (hO]hP]hQ]hR]hU]uhCj~ hY]r hbX executablesr …r‘ }r’ (hBUhCjŒ ubahKh£ubhbX,…r“ }r” (hBX,hCj~ ubeubahKh‘ubhŽ)r• }r– (hBX ``tests``,r— hM}r˜ (hO]hP]hQ]hR]hU]uhCj= hY]r™ hu)rš }r› (hBj— hCj• hIhJhKhyhM}rœ (hO]hP]hQ]hR]hU]uhWMXhY]r (h›)rž }rŸ (hBX ``tests``hM}r  (hO]hP]hQ]hR]hU]uhCjš hY]r” hbXtestsr¢ …r£ }r¤ (hBUhCjž ubahKh£ubhbX,…r„ }r¦ (hBX,hCjš ubeubahKh‘ubhŽ)r§ }rØ (hBX``benches``, ``benchmarks``. hM}r© (hO]hP]hQ]hR]hU]uhCj= hY]rŖ hu)r« }r¬ (hBX``benches``, ``benchmarks``.hCj§ hIhJhKhyhM}r­ (hO]hP]hQ]hR]hU]uhWMYhY]r® (h›)rÆ }r° (hBX ``benches``hM}r± (hO]hP]hQ]hR]hU]uhCj« hY]r² hbXbenchesr³ …r“ }rµ (hBUhCjÆ ubahKh£ubhbX, r¶ …r· }rø (hBX, hCj« ubh›)r¹ }rŗ (hBX``benchmarks``hM}r» (hO]hP]hQ]hR]hU]uhCj« hY]r¼ hbX benchmarksr½ …r¾ }ræ (hBUhCj¹ ubahKh£ubhbX.…rĄ }rĮ (hBX.hCj« ubeubahKh‘ubeubahKU block_quoterĀ ubeubhY]rĆ hu)rÄ }rÅ (hBXUnexpected indentation.hM}rĘ (hO]hP]hQ]hR]hU]uhCjęhY]rĒ hbXUnexpected indentation.rČ …rÉ }rŹ (hBUhCjÄ ubahKhyubahKjŪubeUcurrent_sourcerĖ NU decorationrĢ NUautofootnote_startrĶ KUnameidsrĪ }rĻ (hU%configuring-builds-with-cabal-projectrŠ hU(how-can-i-profile-my-library-applicationrŃ hU quickstartrŅ h Uhaddock-optionsrÓ h Ucmdoption-project-filerŌ h Ucmdoption-store-dirrÕ h j©h Ustatic-linking-optionsrÖ hjyhUsolver-configuration-optionsr× hUhooglerŲ hUhscolourrŁ hjåhUabnfrŚ hjphUid1rŪ hUhackagerÜ hUexecutable-optionsrŻ hUspecifying-the-local-packagesrŽ hj hj«hUhappyrß hj$hUhaskellrą hUcmdoption-builddirrį hUobject-code-optionsrā h U%advanced-global-configuration-optionsrć h!hTh"Upvprä h#U"foreign-function-interface-optionsrå h$Udynamic-linking-optionsrę h%Uadvanced-solver-optionsrē h&Udeveloping-multiple-packagesrč h'Ucoverage-optionsré h(jōh)jš h*Ualexrź h+jSh,jī h-Uglobal-configuration-optionsrė h.Ucpphsrģ h/hjh0Uhaddockrķ h1j¦h2jŠh3j¢ h4Upackage-configuration-optionsrī h5jü h6j h7jČh8Ucookbookrļ h9Upackage-versioning-policyrš h:Uprofiling-optionsrń uhY]rņ (jŠ)ró }rō (hBUhChhIhJhKjhM}rõ (UlangXconsoleUlinenothresholdI9223372036854775807 hR]hQ]hO]hP]hU]uhWKhXhhY]ubhD)rö }r÷ (hBUhChhIhJhKhLhM}rų (hO]hP]hQ]hR]rł jŅ ahU]rś hauhWKhXhhY]rū (h[)rü }rż (hBX Quickstartrž hCjö hIhJhKh_hM}r’ (hO]hP]hQ]hR]hU]uhWKhXhhY]r hbX Quickstartr …r }r (hBjž hINhWNhXhhCjü ubaubhu)r }r (hBXĢSuppose that you are in a directory containing a single Cabal package which you wish to build. You can configure and build it using Nix-style local builds with this command (configuring is not necessary):r hCjö hIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWKhXhhY]r hbXĢSuppose that you are in a directory containing a single Cabal package which you wish to build. You can configure and build it using Nix-style local builds with this command (configuring is not necessary):r …r }r (hBj hINhWNhXhhCj ubaubjš)r }r (hBX$ cabal new-buildhCjö hIhJhKjhM}r (jŸj hR]hQ]hO]hP]hU]uhWK hXhhY]r hbX$ cabal new-buildr …r }r (hBUhCj ubaubhu)r }r (hBX9To open a GHCi shell with this package, use this command:r hCjö hIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWKhXhhY]r hbX9To open a GHCi shell with this package, use this command:r …r }r (hBj hINhWNhXhhCj ubaubjš)r }r (hBX$ cabal new-replhCjö hIhJhKjhM}r (jŸj hR]hQ]hO]hP]hU]uhWKhXhhY]r hbX$ cabal new-replr …r }r! (hBUhCj ubaubhu)r" }r# (hBX?To run an executable defined in this package, use this command:r$ hCjö hIhJhKhyhM}r% (hO]hP]hQ]hR]hU]uhWKhXhhY]r& hbX?To run an executable defined in this package, use this command:r' …r( }r) (hBj$ hINhWNhXhhCj" ubaubjš)r* }r+ (hBX3$ cabal new-run [executable args]hCjö hIhJhKjhM}r, (jŸj hR]hQ]hO]hP]hU]uhWKhXhhY]r- hbX3$ cabal new-run [executable args]r. …r/ }r0 (hBUhCj* ubaubhD)r1 }r2 (hBUhCjö hIhJhKhLhM}r3 (hO]hP]hQ]hR]r4 jč ahU]r5 h&auhWKhXhhY]r6 (h[)r7 }r8 (hBXDeveloping multiple packagesr9 hCj1 hIhJhKh_hM}r: (hO]hP]hQ]hR]hU]uhWKhXhhY]r; hbXDeveloping multiple packagesr< …r= }r> (hBj9 hINhWNhXhhCj7 ubaubhu)r? }r@ (hBX¶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:hCj1 hIhJhKhyhM}rA (hO]hP]hQ]hR]hU]uhWKhXhhY]rB (hbXŒMany Cabal projects involve multiple packages which need to be built together. To build multiple Cabal packages, you need to first create a rC …rD }rE (hBXŒMany Cabal projects involve multiple packages which need to be built together. To build multiple Cabal packages, you need to first create a hINhWNhXhhCj? ubh›)rF }rG (hBX``cabal.project``hM}rH (hO]hP]hQ]hR]hU]uhCj? hY]rI hbX cabal.projectrJ …rK }rL (hBUhCjF ubahKh£ubhbX° 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 rM …rN }rO (hBX° 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 hINhWNhXhhCj? ubh›)rP }rQ (hBX ``Cabal``hM}rR (hO]hP]hQ]hR]hU]uhCj? hY]rS hbXCabalrT …rU }rV (hBUhCjP ubahKh£ubhbX and rW …rX }rY (hBX and hINhWNhXhhCj? ubh›)rZ }r[ (hBX``cabal-install``hM}r\ (hO]hP]hQ]hR]hU]uhCj? hY]r] hbX cabal-installr^ …r_ }r` (hBUhCjZ ubahKh£ubhbX. The ra …rb }rc (hBX. The hINhWNhXhhCj? ubh›)rd }re (hBX``cabal.project``hM}rf (hO]hP]hQ]hR]hU]uhCj? hY]rg hbX cabal.projectrh …ri }rj (hBUhCjd ubahKh£ubhbX3 file specifies each folder as part of the project:rk …rl }rm (hBX3 file specifies each folder as part of the project:hINhWNhXhhCj? ubeubjš)rn }ro (hBX)packages: Cabal/ cabal-install/hCj1 hIhJhKjhM}rp (Ulinenosrq ‰Ulanguagerr XcabaljŸj hR]hQ]hO]Uhighlight_argsrs }hP]hU]uhWK%hXhhY]rt hbX)packages: Cabal/ cabal-install/ru …rv }rw (hBUhCjn ubaubhu)rx }ry (hBXī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.)hCj1 hIhJhKhyhM}rz (hO]hP]hQ]hR]hU]uhWK*hXhhY]r{ (hbXThe expectation is that a r| …r} }r~ (hBXThe expectation is that a hINhWNhXhhCjx ubh›)r }r€ (hBX``cabal.project``hM}r (hO]hP]hQ]hR]hU]uhCjx hY]r‚ hbX cabal.projectrƒ …r„ }r… (hBUhCj ubahKh£ubhbXŠ 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 r† …r‡ }rˆ (hBXŠ 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 hINhWNhXhhCjx ubh›)r‰ }rŠ (hBX``cabal.project.local``hM}r‹ (hO]hP]hQ]hR]hU]uhCjx hY]rŒ hbXcabal.project.localr …rŽ }r (hBUhCj‰ ubahKh£ubhbX" (which should not be checked in.)r …r‘ }r’ (hBX" (which should not be checked in.)hINhWNhXhhCjx ubeubhu)r“ }r” (hBX…Then, to build every component of every package, from the top-level directory, run the command: (using cabal-install-2.0 or greater.)r• hCj1 hIhJhKhyhM}r– (hO]hP]hQ]hR]hU]uhWK/hXhhY]r— hbX…Then, to build every component of every package, from the top-level directory, run the command: (using cabal-install-2.0 or greater.)r˜ …r™ }rš (hBj• hINhWNhXhhCj“ ubaubjš)r› }rœ (hBX$ cabal new-buildhCj1 hIhJhKjhM}r (jŸj hR]hQ]hO]hP]hU]uhWK4hXhhY]rž hbX$ cabal new-buildrŸ …r  }r” (hBUhCj› ubaubhu)r¢ }r£ (hBXlTo build a specific package, you can either run ``new-build`` from the directory of the package in question:hCj1 hIhJhKhyhM}r¤ (hO]hP]hQ]hR]hU]uhWK6hXhhY]r„ (hbX0To build a specific package, you can either run r¦ …r§ }rØ (hBX0To build a specific package, you can either run hINhWNhXhhCj¢ ubh›)r© }rŖ (hBX ``new-build``hM}r« (hO]hP]hQ]hR]hU]uhCj¢ hY]r¬ hbX new-buildr­ …r® }rÆ (hBUhCj© ubahKh£ubhbX/ from the directory of the package in question:r° …r± }r² (hBX/ from the directory of the package in question:hINhWNhXhhCj¢ ubeubjš)r³ }r“ (hBX$$ cd cabal-install $ cabal new-buildhCj1 hIhJhKjhM}rµ (jŸj hR]hQ]hO]hP]hU]uhWK;hXhhY]r¶ hbX$$ cd cabal-install $ cabal new-buildr· …rø }r¹ (hBUhCj³ ubaubhu)rŗ }r» (hBX~or you can pass the name of the package as an argument to ``cabal new-build`` (this works in any subdirectory of the project):hCj1 hIhJhKhyhM}r¼ (hO]hP]hQ]hR]hU]uhWK>hXhhY]r½ (hbX:or you can pass the name of the package as an argument to r¾ …ræ }rĄ (hBX:or you can pass the name of the package as an argument to hINhWNhXhhCjŗ ubh›)rĮ }rĀ (hBX``cabal new-build``hM}rĆ (hO]hP]hQ]hR]hU]uhCjŗ hY]rÄ hbXcabal new-buildrÅ …rĘ }rĒ (hBUhCjĮ ubahKh£ubhbX1 (this works in any subdirectory of the project):rČ …rÉ }rŹ (hBX1 (this works in any subdirectory of the project):hINhWNhXhhCjŗ ubeubjš)rĖ }rĢ (hBX$ cabal new-build cabal-installhCj1 hIhJhKjhM}rĶ (jŸj hR]hQ]hO]hP]hU]uhWKChXhhY]rĪ hbX$ cabal new-build cabal-installrĻ …rŠ }rŃ (hBUhCjĖ ubaubhu)rŅ }rÓ (hBXYou can also specify a specific component of the package to build. For example, to build a test suite named ``package-tests``, use the command:hCj1 hIhJhKhyhM}rŌ (hO]hP]hQ]hR]hU]uhWKEhXhhY]rÕ (hbXlYou can also specify a specific component of the package to build. For example, to build a test suite named rÖ …r× }rŲ (hBXlYou can also specify a specific component of the package to build. For example, to build a test suite named hINhWNhXhhCjŅ ubh›)rŁ }rŚ (hBX``package-tests``hM}rŪ (hO]hP]hQ]hR]hU]uhCjŅ hY]rÜ hbX package-testsrŻ …rŽ }rß (hBUhCjŁ ubahKh£ubhbX, use the command:rą …rį }rā (hBX, use the command:hINhWNhXhhCjŅ ubeubjš)rć }rä (hBX$ cabal new-build package-testshCj1 hIhJhKjhM}rå (jŸj hR]hQ]hO]hP]hU]uhWKJhXhhY]rę hbX$ cabal new-build package-testsrē …rč }ré (hBUhCjć ubaubhu)rź }rė (hBX‡Targets can be qualified with package names. So to request ``package-tests`` *from* the ``Cabal`` package, use ``Cabal:package-tests``.hCj1 hIhJhKhyhM}rģ (hO]hP]hQ]hR]hU]uhWKLhXhhY]rķ (hbX;Targets can be qualified with package names. So to request rī …rļ }rš (hBX;Targets can be qualified with package names. So to request hINhWNhXhhCjź ubh›)rń }rņ (hBX``package-tests``hM}ró (hO]hP]hQ]hR]hU]uhCjź hY]rō hbX package-testsrõ …rö }r÷ (hBUhCjń ubahKh£ubhbX …rų }rł (hBX hINhWNhXhhCjź ubjŖ)rś }rū (hBX*from*hM}rü (hO]hP]hQ]hR]hU]uhCjź hY]rż hbXfromrž …r’ }r(hBUhCjś ubahKj²ubhbX the r…r}r(hBX the hINhWNhXhhCjź ubh›)r}r(hBX ``Cabal``hM}r(hO]hP]hQ]hR]hU]uhCjź hY]rhbXCabalr…r }r (hBUhCjubahKh£ubhbX package, use r …r }r (hBX package, use hINhWNhXhhCjź ubh›)r}r(hBX``Cabal:package-tests``hM}r(hO]hP]hQ]hR]hU]uhCjź hY]rhbXCabal:package-testsr…r}r(hBUhCjubahKh£ubhbX.…r}r(hBX.hINhWNhXhhCjź ubeubhu)r}r(hBX¦Unlike sandboxes, there is no need to setup a sandbox or ``add-source`` projects; just check in ``cabal.project`` to your repository and ``new-build`` will just work.hCj1 hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWKPhXhhY]r(hbX9Unlike sandboxes, there is no need to setup a sandbox or r…r}r(hBX9Unlike sandboxes, there is no need to setup a sandbox or hINhWNhXhhCjubh›)r}r(hBX``add-source``hM}r (hO]hP]hQ]hR]hU]uhCjhY]r!hbX add-sourcer"…r#}r$(hBUhCjubahKh£ubhbX projects; just check in r%…r&}r'(hBX projects; just check in hINhWNhXhhCjubh›)r(}r)(hBX``cabal.project``hM}r*(hO]hP]hQ]hR]hU]uhCjhY]r+hbX cabal.projectr,…r-}r.(hBUhCj(ubahKh£ubhbX to your repository and r/…r0}r1(hBX to your repository and hINhWNhXhhCjubh›)r2}r3(hBX ``new-build``hM}r4(hO]hP]hQ]hR]hU]uhCjhY]r5hbX new-buildr6…r7}r8(hBUhCj2ubahKh£ubhbX will just work.r9…r:}r;(hBX will just work.hINhWNhXhhCjubeubeubeubhD)r<}r=(hBUhChhIhJhKhLhM}r>(hO]hP]hQ]hR]r?jļ ahU]r@h8auhWKUhXhhY]rA(h[)rB}rC(hBXCookbookrDhCj<hIhJhKh_hM}rE(hO]hP]hQ]hR]hU]uhWKUhXhhY]rFhbXCookbookrG…rH}rI(hBjDhINhWNhXhhCjBubaubhD)rJ}rK(hBUhCj<hIhJhKhLhM}rL(hO]hP]hQ]hR]rMjŃ ahU]rNhauhWKXhXhhY]rO(h[)rP}rQ(hBX)How can I profile my library/application?rRhCjJhIhJhKh_hM}rS(hO]hP]hQ]hR]hU]uhWKXhXhhY]rThbX)How can I profile my library/application?rU…rV}rW(hBjRhINhWNhXhhCjPubaubhu)rX}rY(hBXHCreate or edit your ``cabal.project.local``, adding the following line::hCjJhIhJhKhyhM}rZ(hO]hP]hQ]hR]hU]uhWKZhXhhY]r[(hbXCreate or edit your r\…r]}r^(hBXCreate or edit your hINhWNhXhhCjXubh›)r_}r`(hBX``cabal.project.local``hM}ra(hO]hP]hQ]hR]hU]uhCjXhY]rbhbXcabal.project.localrc…rd}re(hBUhCj_ubahKh£ubhbX, adding the following line:rf…rg}rh(hBX, adding the following line:hINhWNhXhhCjXubeubjš)ri}rj(hBXprofiling: TruehCjJhIhJhKjhM}rk(jŸj hR]hQ]hO]hP]hU]uhWK]hXhhY]rlhbXprofiling: Truerm…rn}ro(hBUhCjiubaubhu)rp}rq(hBXĄNow, ``cabal new-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`::hCjJhIhJhKhyhM}rr(hO]hP]hQ]hR]hU]uhWK_hXhhY]rs(hbXNow, rt…ru}rv(hBXNow, hINhWNhXhhCjpubh›)rw}rx(hBX``cabal new-build``hM}ry(hO]hP]hQ]hR]hU]uhCjphY]rzhbXcabal new-buildr{…r|}r}(hBUhCjwubahKh£ubhbX‰ will automatically build all libraries and executables with profiling. You can fine-tune the profiling settings for each package using r~…r}r€(hBX‰ will automatically build all libraries and executables with profiling. You can fine-tune the profiling settings for each package using hINhWNhXhhCjpubj[)r}r‚(hBX:cfg-field:`profiling-detail`rƒhCjphIhJhKj_hM}r„(UreftypeX cfg-fieldjaˆjbXprofiling-detailU refdomainXcabalr…hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWK_hY]r†h›)r‡}rˆ(hBjƒhM}r‰(hO]hP]rŠ(jlj…Xcabal-cfg-fieldr‹ehQ]hR]hU]uhCjhY]rŒhbXprofiling-detailr…rŽ}r(hBUhCj‡ubahKh£ubaubhbX:…r}r‘(hBX:hINhWNhXhhCjpubeubjš)r’}r“(hBX2package p profiling-detail: toplevel-functionshCjJhIhJhKjhM}r”(jŸj hR]hQ]hO]hP]hU]uhWKchXhhY]r•hbX2package p profiling-detail: toplevel-functionsr–…r—}r˜(hBUhCj’ubaubhu)r™}rš(hBXeAlternately, you can call ``cabal new-build --enable-profiling`` to temporarily build with profiling.hCjJhIhJhKhyhM}r›(hO]hP]hQ]hR]hU]uhWKfhXhhY]rœ(hbXAlternately, you can call r…rž}rŸ(hBXAlternately, you can call hINhWNhXhhCj™ubh›)r }r”(hBX&``cabal new-build --enable-profiling``hM}r¢(hO]hP]hQ]hR]hU]uhCj™hY]r£hbX"cabal new-build --enable-profilingr¤…r„}r¦(hBUhCj ubahKh£ubhbX% to temporarily build with profiling.r§…rØ}r©(hBX% to temporarily build with profiling.hINhWNhXhhCj™ubeubeubeubhGjšhD)rŖ}r«(hBUhChhIhJhKhLhM}r¬(hO]hP]hQ]hR]r­jŠ ahU]r®hauhWMxhXhhY]rÆ(h[)r°}r±(hBX%Configuring builds with cabal.projectr²hCjŖhIhJhKh_hM}r³(hO]hP]hQ]hR]hU]uhWMxhXhhY]r“hbX%Configuring builds with cabal.projectrµ…r¶}r·(hBj²hINhWNhXhhCj°ubaubhu)rø}r¹(hBXó``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:hCjŖhIhJhKhyhM}rŗ(hO]hP]hQ]hR]hU]uhWMzhXhhY]r»(h›)r¼}r½(hBX``cabal.project``hM}r¾(hO]hP]hQ]hR]hU]uhCjøhY]ræhbX cabal.projectrĄ…rĮ}rĀ(hBUhCj¼ubahKh£ubhbXg files support a variety of options which configure the details of your build. The general syntax of a rĆ…rÄ}rÅ(hBXg files support a variety of options which configure the details of your build. The general syntax of a hINhWNhXhhCjøubh›)rĘ}rĒ(hBX``cabal.project``hM}rČ(hO]hP]hQ]hR]hU]uhCjøhY]rÉhbX cabal.projectrŹ…rĖ}rĢ(hBUhCjĘubahKh£ubhbXj file is similar to that of a Cabal file: there are a number of fields, some of which live inside stanzas:rĶ…rĪ}rĻ(hBXj file is similar to that of a Cabal file: there are a number of fields, some of which live inside stanzas:hINhWNhXhhCjøubeubjš)rŠ}rŃ(hBXcpackages: */*.cabal with-compiler: /opt/ghc/8.0.1/bin/ghc package cryptohash optimization: FalsehCjŖhIhJhKjhM}rŅ(jŸj hR]hQ]hO]hP]hU]uhWMhXhhY]rÓhbXcpackages: */*.cabal with-compiler: /opt/ghc/8.0.1/bin/ghc package cryptohash optimization: FalserŌ…rÕ}rÖ(hBUhCjŠubaubhu)r×}rŲ(hBXņIn general, the accepted field names coincide with the accepted command line flags that ``cabal install`` and other commands take. For example, ``cabal new-configure --enable-profiling`` will write out a project file with ``profiling: True``.hCjŖhIhJhKhyhM}rŁ(hO]hP]hQ]hR]hU]uhWM‡hXhhY]rŚ(hbXXIn general, the accepted field names coincide with the accepted command line flags that rŪ…rÜ}rŻ(hBXXIn general, the accepted field names coincide with the accepted command line flags that hINhWNhXhhCj×ubh›)rŽ}rß(hBX``cabal install``hM}rą(hO]hP]hQ]hR]hU]uhCj×hY]rįhbX cabal installrā…rć}rä(hBUhCjŽubahKh£ubhbX' and other commands take. For example, r允rę}rē(hBX' and other commands take. For example, hINhWNhXhhCj×ubh›)rč}ré(hBX*``cabal new-configure --enable-profiling``hM}rź(hO]hP]hQ]hR]hU]uhCj×hY]rėhbX&cabal new-configure --enable-profilingrģ…rķ}rī(hBUhCjčubahKh£ubhbX$ will write out a project file with rļ…rš}rń(hBX$ will write out a project file with hINhWNhXhhCj×ubh›)rņ}ró(hBX``profiling: True``hM}rō(hO]hP]hQ]hR]hU]uhCj×hY]rõhbXprofiling: Truerö…r÷}rų(hBUhCjņubahKh£ubhbX.…rł}rś(hBX.hINhWNhXhhCj×ubeubhu)rū}rü(hBX{The full configuration of a project is determined by combining the following sources (later entries override earlier ones):rżhCjŖhIhJhKhyhM}rž(hO]hP]hQ]hR]hU]uhWMŒhXhhY]r’hbX{The full configuration of a project is determined by combining the following sources (later entries override earlier ones):r…r}r(hBjżhINhWNhXhhCjūubaubjć)r}r(hBUhCjŖhIhJhKjęhM}r(jčU.hR]hQ]hO]jéUhP]hU]jźjėuhWMhXhhY]r(hŽ)r}r(hBX9``~/.cabal/config`` (the user-wide global configuration) hCjhIhJhKh‘hM}r (hO]hP]hQ]hR]hU]uhWNhXhhY]r hu)r }r (hBX8``~/.cabal/config`` (the user-wide global configuration)hCjhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMhY]r(h›)r}r(hBX``~/.cabal/config``hM}r(hO]hP]hQ]hR]hU]uhCj hY]rhbX~/.cabal/configr…r}r(hBUhCjubahKh£ubhbX% (the user-wide global configuration)r…r}r(hBX% (the user-wide global configuration)hCj ubeubaubhŽ)r}r(hBX.``cabal.project`` (the project configuratoin) hCjhIhJhKh‘hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rhu)r}r(hBX-``cabal.project`` (the project configuratoin)hCjhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM‘hY]r (h›)r!}r"(hBX``cabal.project``hM}r#(hO]hP]hQ]hR]hU]uhCjhY]r$hbX cabal.projectr%…r&}r'(hBUhCj!ubahKh£ubhbX (the project configuratoin)r(…r)}r*(hBX (the project configuratoin)hCjubeubaubhŽ)r+}r,(hBX>``cabal.project.freeze`` (the output of ``cabal new-freeze``) hCjhIhJhKh‘hM}r-(hO]hP]hQ]hR]hU]uhWNhXhhY]r.hu)r/}r0(hBX=``cabal.project.freeze`` (the output of ``cabal new-freeze``)hCj+hIhJhKhyhM}r1(hO]hP]hQ]hR]hU]uhWM“hY]r2(h›)r3}r4(hBX``cabal.project.freeze``hM}r5(hO]hP]hQ]hR]hU]uhCj/hY]r6hbXcabal.project.freezer7…r8}r9(hBUhCj3ubahKh£ubhbX (the output of r:…r;}r<(hBX (the output of hCj/ubh›)r=}r>(hBX``cabal new-freeze``hM}r?(hO]hP]hQ]hR]hU]uhCj/hY]r@hbXcabal new-freezerA…rB}rC(hBUhCj=ubahKh£ubhbX)…rD}rE(hBX)hCj/ubeubaubhŽ)rF}rG(hBXA``cabal.project.local`` (the output of ``cabal new-configure``) hCjhIhJhKh‘hM}rH(hO]hP]hQ]hR]hU]uhWNhXhhY]rIhu)rJ}rK(hBX?``cabal.project.local`` (the output of ``cabal new-configure``)hCjFhIhJhKhyhM}rL(hO]hP]hQ]hR]hU]uhWM•hY]rM(h›)rN}rO(hBX``cabal.project.local``hM}rP(hO]hP]hQ]hR]hU]uhCjJhY]rQhbXcabal.project.localrR…rS}rT(hBUhCjNubahKh£ubhbX (the output of rU…rV}rW(hBX (the output of hCjJubh›)rX}rY(hBX``cabal new-configure``hM}rZ(hO]hP]hQ]hR]hU]uhCjJhY]r[hbXcabal new-configurer\…r]}r^(hBUhCjXubahKh£ubhbX)…r_}r`(hBX)hCjJubeubaubeubhD)ra}rb(hBUhCjŖhIhJhKhLhM}rc(hO]hP]hQ]hR]rdjŽ ahU]rehauhWM™hXhhY]rf(h[)rg}rh(hBXSpecifying the local packagesrihCjahIhJhKh_hM}rj(hO]hP]hQ]hR]hU]uhWM™hXhhY]rkhbXSpecifying the local packagesrl…rm}rn(hBjihINhWNhXhhCjgubaubhu)ro}rp(hBXQThe following top-level options specify what the local packages of a project are:rqhCjahIhJhKhyhM}rr(hO]hP]hQ]hR]hU]uhWM›hXhhY]rshbXQThe following top-level options specify what the local packages of a project are:rt…ru}rv(hBjqhINhWNhXhhCjoubaubcsphinx.addnodes index rw)rx}ry(hBUhCjahIhJhKUindexrzhM}r{(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubcsphinx.addnodes desc r|)r}}r~(hBUhCjahIhJhKUdescrhM}r€(Unoindexr‰Udomainr‚XcabalhR]hQ]hO]hP]hU]UobjtyperƒX cfg-fieldr„Udesctyper…j„uhWNhXhhY]r†(csphinx.addnodes desc_signature r‡)rˆ}r‰(hBX:packages: package location list (space or comma separated)hCj}hIhJhKUdesc_signaturerŠhM}r‹(hR]rŒXcfg-field-packagesrahQ]hO]hP]hU]UfirstrŽ‰uhWNhXhhY]r(jw)r}r‘(hBUhCjˆhIhJhKjzhM}r’(hR]hQ]hO]hP]hU]Uentries]r“(Upairr”Xpackages ; cabal project optionjUNtr•auhWNhXhhY]ubcsphinx.addnodes desc_name r–)r—}r˜(hBXpackagesr™hCjˆhIhJhKU desc_nameršhM}r›(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rœhbXpackagesr…rž}rŸ(hBUhINhWNhXhhCj—ubaubcsphinx.addnodes desc_addname r )r”}r¢(hBU: r£hCjˆhIhJhKU desc_addnamer¤hM}r„(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¦hbX: r§…rØ}r©(hBUhINhWNhXhhCj”ubaubcsphinx.addnodes desc_annotation rŖ)r«}r¬(hBX0package location list (space or comma separated)hCjˆhIhJhKUdesc_annotationr­hM}r®(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÆhbX0package location list (space or comma separated)r°…r±}r²(hBUhINhWNhXhhCj«ubaubeubcsphinx.addnodes desc_content r³)r“}rµ(hBUhCj}hIhJhKU desc_contentr¶hM}r·(hO]hP]hQ]hR]hU]uhWNhXhhY]rø(cdocutils.nodes field_list r¹)rŗ}r»(hBUhCj“hIhJhKU field_listr¼hM}r½(hO]hP]hQ]hR]hU]uhWNhXhhY]r¾cdocutils.nodes field ræ)rĄ}rĮ(hBUhM}rĀ(hO]hP]hQ]hR]hU]uhCjŗhY]rĆ(cdocutils.nodes field_name rÄ)rÅ}rĘ(hBX Default valuehCjĄhIhJhKU field_namerĒhM}rČ(hO]hP]hQ]hR]hU]uhWKhY]rÉhbX Default valuerŹ…rĖ}rĢ(hBUhCjÅubaubcdocutils.nodes field_body rĶ)rĪ}rĻ(hBUhM}rŠ(hO]hP]hQ]hR]hU]uhCjĄhY]rŃhu)rŅ}rÓ(hBX ./*.cabalhM}rŌ(hO]hP]hQ]hR]hU]uhCjĪhY]rÕh›)rÖ}r×(hBX ``./*.cabal``hCjŅhIhJhKh£hM}rŲ(hO]hP]hQ]hR]hU]uhWNhXhhY]rŁhbX ./*.cabalrŚ…rŪ}rÜ(hBUhINhWNhXhhCjÖubaubahKhyubahKU field_bodyrŻubehKUfieldrŽubaubhu)rß}rą(hBX•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įhCj“hIhJhKhyhM}rā(hO]hP]hQ]hR]hU]uhWM£hXhhY]rćhbX•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ę(hBjįhINhWNhXhhCjßubaubjć)rē}rč(hBUhCj“hIhJhKjęhM}ré(jčU.hR]hQ]hO]jéUhP]hU]jźjėuhWM§hXhhY]rź(hŽ)rė}rģ(hBX„They can specify a Cabal file, or a directory containing a Cabal file, e.g., ``packages: Cabal cabal-install/cabal-install.cabal``. hCjēhIhJhKh‘hM}rķ(hO]hP]hQ]hR]hU]uhWNhXhhY]rīhu)rļ}rš(hBXƒThey can specify a Cabal file, or a directory containing a Cabal file, e.g., ``packages: Cabal cabal-install/cabal-install.cabal``.hCjėhIhJhKhyhM}rń(hO]hP]hQ]hR]hU]uhWM§hY]rņ(hbXMThey can specify a Cabal file, or a directory containing a Cabal file, e.g., ró…rō}rõ(hBXMThey can specify a Cabal file, or a directory containing a Cabal file, e.g., hCjļubh›)rö}r÷(hBX5``packages: Cabal cabal-install/cabal-install.cabal``hM}rų(hO]hP]hQ]hR]hU]uhCjļhY]rłhbX1packages: Cabal cabal-install/cabal-install.cabalrś…rū}rü(hBUhCjöubahKh£ubhbX.…rż}rž(hBX.hCjļubeubaubhŽ)r’}r(hBXš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}/`` hCjēhIhJhKh‘hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rhu)r}r(hBX™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}/``hCj’hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMŖhY]r(hbX“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 (hBX“They can specify a glob-style wildcards, which must match one or more (a) directories containing a (single) Cabal file, (b) Cabal files (extension hCjubh›)r }r (hBX ``.cabal``hM}r (hO]hP]hQ]hR]hU]uhCjhY]r hbX.cabalr…r}r(hBUhCj ubahKh£ubhbX;), or (c) tarballs which contain Cabal packages (extension r…r}r(hBX;), or (c) tarballs which contain Cabal packages (extension hCjubh›)r}r(hBX ``.tar.gz``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbX.tar.gzr…r}r(hBUhCjubahKh£ubhbXx). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories r…r}r(hBXx). For example, to match all Cabal files in all subdirectories, as well as the Cabal projects in the parent directories hCjubh›)r}r(hBX``foo``hM}r (hO]hP]hQ]hR]hU]uhCjhY]r!hbXfoor"…r#}r$(hBUhCjubahKh£ubhbX and r%…r&}r'(hBX and hCjubh›)r(}r)(hBX``bar``hM}r*(hO]hP]hQ]hR]hU]uhCjhY]r+hbXbarr,…r-}r.(hBUhCj(ubahKh£ubhbX, use r/…r0}r1(hBX, use hCjubh›)r2}r3(hBX%``packages: */*.cabal ../{foo,bar}/``hM}r4(hO]hP]hQ]hR]hU]uhCjhY]r5hbX!packages: */*.cabal ../{foo,bar}/r6…r7}r8(hBUhCj2ubahKh£ubeubaubhŽ)r9}r:(hBX”[STRIKEOUT:They can specify an ``http``, ``https`` or ``file`` URL, representing the path to a remote tarball to be downloaded and built.] (not implemented yet) hCjēhIhJhKh‘hM}r;(hO]hP]hQ]hR]hU]uhWNhXhhY]r<hu)r=}r>(hBX [STRIKEOUT:They can specify an ``http``, ``https`` or ``file`` URL, representing the path to a remote tarball to be downloaded and built.] (not implemented yet)hCj9hIhJhKhyhM}r?(hO]hP]hQ]hR]hU]uhWM³hY]r@(hbX[STRIKEOUT:They can specify an rA…rB}rC(hBX[STRIKEOUT:They can specify an hCj=ubh›)rD}rE(hBX``http``hM}rF(hO]hP]hQ]hR]hU]uhCj=hY]rGhbXhttprH…rI}rJ(hBUhCjDubahKh£ubhbX, rK…rL}rM(hBX, hCj=ubh›)rN}rO(hBX ``https``hM}rP(hO]hP]hQ]hR]hU]uhCj=hY]rQhbXhttpsrR…rS}rT(hBUhCjNubahKh£ubhbX or rU…rV}rW(hBX or hCj=ubh›)rX}rY(hBX``file``hM}rZ(hO]hP]hQ]hR]hU]uhCj=hY]r[hbXfiler\…r]}r^(hBUhCjXubahKh£ubhbXb URL, representing the path to a remote tarball to be downloaded and built.] (not implemented yet)r_…r`}ra(hBXb URL, representing the path to a remote tarball to be downloaded and built.] (not implemented yet)hCj=ubeubaubeubhu)rb}rc(hBXBThere is no command line variant of this field; see :issue:`3585`.hCj“hIhJhKhyhM}rd(hO]hP]hQ]hR]hU]uhWM·hXhhY]re(hbX4There is no command line variant of this field; see rf…rg}rh(hBX4There is no command line variant of this field; see hINhWNhXhhCjbubji)ri}rj(hBX#3585hM}rk(UrefuriX,https://github.com/haskell/cabal/issues/3585hR]hQ]hO]hP]hU]Uinternal‰uhCjbhY]rlhbX#3585rm…rn}ro(hBUhCjiubahKjrubhbX.…rp}rq(hBX.hINhWNhXhhCjbubeubeubeubjw)rr}rs(hBUhCjahIhJhKjzhM}rt(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)ru}rv(hBUhCjahIhJhKjhM}rw(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrxj…jxuhWNhXhhY]ry(j‡)rz}r{(hBXCoptional-packages: package location list (space or comma-separated)hCjuhIhJhKjŠhM}r|(hR]r}Xcfg-field-optional-packagesr~ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r(jw)r€}r(hBUhCjzhIhJhKjzhM}r‚(hR]hQ]hO]hP]hU]Uentries]rƒ(j”X(optional-packages ; cabal project optionj~UNtr„auhWNhXhhY]ubj–)r…}r†(hBXoptional-packagesr‡hCjzhIhJhKjšhM}rˆ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‰hbXoptional-packagesrŠ…r‹}rŒ(hBUhINhWNhXhhCj…ubaubj )r}rŽ(hBj£hCjzhIhJhKj¤hM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX: r‘…r’}r“(hBUhINhWNhXhhCjubaubjŖ)r”}r•(hBX0package location list (space or comma-separated)hCjzhIhJhKj­hM}r–(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r—hbX0package location list (space or comma-separated)r˜…r™}rš(hBUhINhWNhXhhCj”ubaubeubj³)r›}rœ(hBUhCjuhIhJhKj¶hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rž(j¹)rŸ}r (hBUhCj›hIhJhKj¼hM}r”(hO]hP]hQ]hR]hU]uhWNhXhhY]r¢jæ)r£}r¤(hBUhM}r„(hO]hP]hQ]hR]hU]uhCjŸhY]r¦(jÄ)r§}rØ(hBX Default valuehCj£hIhJhKjĒhM}r©(hO]hP]hQ]hR]hU]uhWKhY]rŖhbX Default valuer«…r¬}r­(hBUhCj§ubaubjĶ)r®}rÆ(hBUhM}r°(hO]hP]hQ]hR]hU]uhCj£hY]r±hu)r²}r³(hBX ./*/*.cabalhM}r“(hO]hP]hQ]hR]hU]uhCj®hY]rµh›)r¶}r·(hBX``./*/*.cabal``hCj²hIhJhKh£hM}rø(hO]hP]hQ]hR]hU]uhWNhXhhY]r¹hbX ./*/*.cabalrŗ…r»}r¼(hBUhINhWNhXhhCj¶ubaubahKhyubahKjŻubehKjŽubaubhu)r½}r¾(hBXØ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.hCj›hIhJhKhyhM}ræ(hO]hP]hQ]hR]hU]uhWM¾hXhhY]rĄ(hbXLike rĮ…rĀ}rĆ(hBXLike hINhWNhXhhCj½ubj[)rÄ}rÅ(hBX:cfg-field:`packages`rĘhCj½hIhJhKj_hM}rĒ(UreftypeX cfg-fieldjaˆjbXpackagesU refdomainXcabalrČhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM¾hY]rÉh›)rŹ}rĖ(hBjĘhM}rĢ(hO]hP]rĶ(jljČXcabal-cfg-fieldrĪehQ]hR]hU]uhCjÄhY]rĻhbXpackagesrŠ…rŃ}rŅ(hBUhCjŹubahKh£ubaubhbXV, specifies a list of package locations containing local packages to be built. Unlike rÓ…rŌ}rÕ(hBXV, specifies a list of package locations containing local packages to be built. Unlike hINhWNhXhhCj½ubj[)rÖ}r×(hBX:cfg-field:`packages`rŲhCj½hIhJhKj_hM}rŁ(UreftypeX cfg-fieldjaˆjbXpackagesU refdomainXcabalrŚhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM¾hY]rŪh›)rÜ}rŻ(hBjŲhM}rŽ(hO]hP]rß(jljŚXcabal-cfg-fieldrąehQ]hR]hU]uhCjÖhY]rįhbXpackagesrā…rć}rä(hBUhCjÜubahKh£ubaubhbXu, 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ē(hBXu, if we glob for a package, it is permissible for the glob to match against zero packages. The intended use-case for hINhWNhXhhCj½ubj[)rč}ré(hBX:cfg-field:`optional-packages`rźhCj½hIhJhKj_hM}rė(UreftypeX cfg-fieldjaˆjbXoptional-packagesU refdomainXcabalrģhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM¾hY]rķh›)rī}rļ(hBjźhM}rš(hO]hP]rń(jljģXcabal-cfg-fieldrņehQ]hR]hU]uhCjčhY]róhbXoptional-packagesrō…rõ}rö(hBUhCjīubahKh£ubaubhbX’ 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ł(hBX 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.hINhWNhXhhCj½ubeubhu)rś}rū(hBX/There is no command line variant of this field.rühCj›hIhJhKhyhM}rż(hO]hP]hQ]hR]hU]uhWMÅhXhhY]ržhbX/There is no command line variant of this field.r’…r}r(hBjühINhWNhXhhCjśubaubeubeubjw)r}r(hBUhCjahIhJhKjzhM}r(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r}r(hBUhCjahIhJhKjhM}r(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrj…juhWNhXhhY]r (j‡)r }r (hBXBextra-packages: package list with version bounds (comma separated)hCjhIhJhKjŠhM}r (hR]r Xcfg-field-extra-packagesrahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r(jw)r}r(hBUhCj hIhJhKjzhM}r(hR]hQ]hO]hP]hU]Uentries]r(j”X%extra-packages ; cabal project optionjUNtrauhWNhXhhY]ubj–)r}r(hBXextra-packagesrhCj hIhJhKjšhM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbXextra-packagesr…r}r(hBUhINhWNhXhhCjubaubj )r}r(hBj£hCj hIhJhKj¤hM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX: r!…r"}r#(hBUhINhWNhXhhCjubaubjŖ)r$}r%(hBX2package list with version bounds (comma separated)hCj hIhJhKj­hM}r&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r'hbX2package list with version bounds (comma separated)r(…r)}r*(hBUhINhWNhXhhCj$ubaubeubj³)r+}r,(hBUhCjhIhJhKj¶hM}r-(hO]hP]hQ]hR]hU]uhWNhXhhY]r.(hu)r/}r0(hBX{[STRIKEOUT:Specifies a list of external packages from Hackage which should be considered local packages.] (Not implemented)r1hCj+hIhJhKhyhM}r2(hO]hP]hQ]hR]hU]uhWMŹhXhhY]r3hbX{[STRIKEOUT:Specifies a list of external packages from Hackage which should be considered local packages.] (Not implemented)r4…r5}r6(hBj1hINhWNhXhhCj/ubaubhu)r7}r8(hBX/There is no command line variant of this field.r9hCj+hIhJhKhyhM}r:(hO]hP]hQ]hR]hU]uhWMĶhXhhY]r;hbX/There is no command line variant of this field.r<…r=}r>(hBj9hINhWNhXhhCj7ubaubeubeubhu)r?}r@(hBX[STRIKEOUT:There is also a stanza ``source-repository-package`` for specifying packages from an external version control.] (Not implemented.)hCjahIhJhKhyhM}rA(hO]hP]hQ]hR]hU]uhWMĻhXhhY]rB(hbX"[STRIKEOUT:There is also a stanza rC…rD}rE(hBX"[STRIKEOUT:There is also a stanza hINhWNhXhhCj?ubh›)rF}rG(hBX``source-repository-package``hM}rH(hO]hP]hQ]hR]hU]uhCj?hY]rIhbXsource-repository-packagerJ…rK}rL(hBUhCjFubahKh£ubhbXN for specifying packages from an external version control.] (Not implemented.)rM…rN}rO(hBXN for specifying packages from an external version control.] (Not implemented.)hINhWNhXhhCj?ubeubhu)rP}rQ(hBXō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::hCjahIhJhKhyhM}rR(hO]hP]hQ]hR]hU]uhWMÓhXhhY]rS(hbXAll local packages are rT…rU}rV(hBXAll local packages are hINhWNhXhhCjPubjŖ)rW}rX(hBX *vendored*hM}rY(hO]hP]hQ]hR]hU]uhCjPhY]rZhbXvendoredr[…r\}r](hBUhCjWubahKj²ubhbXŅ, 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`(hBXŅ, 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:hINhWNhXhhCjPubeubjš)ra}rb(hBX2packages: ./*.cabal optional-packages: ./*/*.cabalhCjahIhJhKjhM}rc(jŸj hR]hQ]hO]hP]hU]uhWMŲhXhhY]rdhbX2packages: ./*.cabal optional-packages: ./*/*.cabalre…rf}rg(hBUhCjaubaubhu)rh}ri(hBX—...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::hCjahIhJhKhyhM}rj(hO]hP]hQ]hR]hU]uhWMŪhXhhY]rkhbX–ā€¦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:rl…rm}rn(hBX–...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:hINhWNhXhhCjhubaubjš)ro}rp(hBXUfoo.cabal foo-helper/ # local package unix/ # vendored external packagehCjahIhJhKjhM}rq(jŸj hR]hQ]hO]hP]hU]uhWMßhXhhY]rrhbXUfoo.cabal foo-helper/ # local package unix/ # vendored external packagers…rt}ru(hBUhCjoubaubhu)rv}rw(hBXPAll of these options support globs. ``cabal new-build`` has its own glob format:hCjahIhJhKhyhM}rx(hO]hP]hQ]hR]hU]uhWMćhXhhY]ry(hbX$All of these options support globs. rz…r{}r|(hBX$All of these options support globs. hINhWNhXhhCjvubh›)r}}r~(hBX``cabal new-build``hM}r(hO]hP]hQ]hR]hU]uhCjvhY]r€hbXcabal new-buildr…r‚}rƒ(hBUhCj}ubahKh£ubhbX has its own glob format:r„…r…}r†(hBX has its own glob format:hINhWNhXhhCjvubeubh‡)r‡}rˆ(hBUhCjahIhJhKhŠhM}r‰(hŒX-hR]hQ]hO]hP]hU]uhWMęhXhhY]rŠ(hŽ)r‹}rŒ(hBX_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). hCj‡hIhJhKh‘hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rŽhu)r}r(hBX^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).hCj‹hIhJhKhyhM}r‘(hO]hP]hQ]hR]hU]uhWMęhY]r’(hbXKAnywhere in a path, as many times as you like, you can specify an asterisk r“…r”}r•(hBXKAnywhere in a path, as many times as you like, you can specify an asterisk hCjubh›)r–}r—(hBX``*``hM}r˜(hO]hP]hQ]hR]hU]uhCjhY]r™hbX*…rš}r›(hBUhCj–ubahKh£ubhbX wildcard. E.g., rœ…r}rž(hBX wildcard. E.g., hCjubh›)rŸ}r (hBX ``*/*.cabal``hM}r”(hO]hP]hQ]hR]hU]uhCjhY]r¢hbX */*.cabalr£…r¤}r„(hBUhCjŸubahKh£ubhbX matches all r¦…r§}rØ(hBX matches all hCjubh›)r©}rŖ(hBX ``.cabal``hM}r«(hO]hP]hQ]hR]hU]uhCjhY]r¬hbX.cabalr­…r®}rÆ(hBUhCj©ubahKh£ubhbX‡ 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±}r²(hBX‡ files in all immediate subdirectories. Like in glob(7), asterisks do not match hidden files unless there is an explicit period, e.g., hCjubh›)r³}r“(hBX``.*/foo.cabal``hM}rµ(hO]hP]hQ]hR]hU]uhCjhY]r¶hbX .*/foo.cabalr·…rø}r¹(hBUhCj³ubahKh£ubhbX will match rŗ…r»}r¼(hBX will match hCjubh›)r½}r¾(hBX``.private/foo.cabal``hM}ræ(hO]hP]hQ]hR]hU]uhCjhY]rĄhbX.private/foo.cabalrĮ…rĀ}rĆ(hBUhCj½ubahKh£ubhbX (but rÄ…rÅ}rĘ(hBX (but hCjubh›)rĒ}rČ(hBX``*/foo.cabal``hM}rÉ(hO]hP]hQ]hR]hU]uhCjhY]rŹhbX */foo.cabalrĖ…rĢ}rĶ(hBUhCjĒubahKh£ubhbX will not).rĪ…rĻ}rŠ(hBX will not).hCjubeubaubhŽ)rŃ}rŅ(hBX›You can use braces to specify specific directories; e.g., ``{vendor,pkgs}/*.cabal`` matches all Cabal files in the ``vendor`` and ``pkgs`` subdirectories. hCj‡hIhJhKh‘hM}rÓ(hO]hP]hQ]hR]hU]uhWNhXhhY]rŌhu)rÕ}rÖ(hBXšYou can use braces to specify specific directories; e.g., ``{vendor,pkgs}/*.cabal`` matches all Cabal files in the ``vendor`` and ``pkgs`` subdirectories.hCjŃhIhJhKhyhM}r×(hO]hP]hQ]hR]hU]uhWMķhY]rŲ(hbX:You can use braces to specify specific directories; e.g., rŁ…rŚ}rŪ(hBX:You can use braces to specify specific directories; e.g., hCjÕubh›)rÜ}rŻ(hBX``{vendor,pkgs}/*.cabal``hM}rŽ(hO]hP]hQ]hR]hU]uhCjÕhY]rßhbX{vendor,pkgs}/*.cabalrą…rį}rā(hBUhCjÜubahKh£ubhbX matches all Cabal files in the r慁rä}rå(hBX matches all Cabal files in the hCjÕubh›)rę}rē(hBX ``vendor``hM}rč(hO]hP]hQ]hR]hU]uhCjÕhY]réhbXvendorrź…rė}rģ(hBUhCjęubahKh£ubhbX and rķ…rī}rļ(hBX and hCjÕubh›)rš}rń(hBX``pkgs``hM}rņ(hO]hP]hQ]hR]hU]uhCjÕhY]róhbXpkgsrō…rõ}rö(hBUhCjšubahKh£ubhbX subdirectories.r÷…rų}rł(hBX subdirectories.hCjÕubeubaubeubhu)rś}rū(hBX4Formally, the format described by the following BNF:rühCjahIhJhKhyhM}rż(hO]hP]hQ]hR]hU]uhWMńhXhhY]ržhbX4Formally, the format described by the following BNF:r’…r}r(hBjühINhWNhXhhCjśubaubjš)r}r(hBXā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)hCjahIhJhKjhM}r(jq ‰jr XabnfjŸj hR]hQ]hO]js }hP]hU]uhWMóhXhhY]rhbXā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(hBUhCjubaubeubhD)r }r (hBUhCjŖhIhJhKhLhM}r (hO]hP]hQ]hR]r jė ahU]r h-auhWMhXhhY]r(h[)r}r(hBXGlobal configuration optionsrhCj hIhJhKh_hM}r(hO]hP]hQ]hR]hU]uhWMhXhhY]rhbXGlobal configuration optionsr…r}r(hBjhINhWNhXhhCjubaubhu)r}r(hBXgThe following top-level configuration options are not specific to any package, and thus apply globally:rhCj hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMhXhhY]rhbXgThe following top-level configuration options are not specific to any package, and thus apply globally:r…r}r(hBjhINhWNhXhhCjubaubjw)r}r (hBUhCj hIhJhKjzhM}r!(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r"}r#(hBUhCj hIhJhKjhM}r$(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr%j…j%uhWNhXhhY]r&(j‡)r'}r((hBX verbose: nathCj"hIhJhKjŠhM}r)(hR]r*Xcfg-field-verboser+ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r,(jw)r-}r.(hBUhCj'hIhJhKjzhM}r/(hR]hQ]hO]hP]hU]Uentries]r0(j”Xverbose ; cabal project optionj+UNtr1auhWNhXhhY]ubj–)r2}r3(hBXverboser4hCj'hIhJhKjšhM}r5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r6hbXverboser7…r8}r9(hBUhINhWNhXhhCj2ubaubj )r:}r;(hBj£hCj'hIhJhKj¤hM}r<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r=hbX: r>…r?}r@(hBUhINhWNhXhhCj:ubaubjŖ)rA}rB(hBXnathCj'hIhJhKj­hM}rC(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rDhbXnatrE…rF}rG(hBUhINhWNhXhhCjAubaubeubj‡)rH}rI(hBX--verbose=n, -vnhCj"hIhJhKjŠhM}rJ(hR]rKXcfg-flag---verboserLahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rM(jw)rN}rO(hBUhCjHhIhJhKjzhM}rP(hR]hQ]hO]hP]hU]Uentries]rQ(j”X--verbose; cabal project optionjLUNtrRauhWNhXhhY]ubj–)rS}rT(hBX --verboserUhCjHhIhJhKjšhM}rV(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rWhbX --verboserX…rY}rZ(hBUhINhWNhXhhCjSubaubj )r[}r\(hBX=nhCjHhIhJhKj¤hM}r](jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r^hbX=nr_…r`}ra(hBUhINhWNhXhhCj[ubaubj–)rb}rc(hBU, rdhCjHhIhJhKjšhM}re(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rfhbX, rg…rh}ri(hBUhINhWNhXhhCjbubaubj–)rj}rk(hBX-vnhCjHhIhJhKjšhM}rl(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rmhbX-vnrn…ro}rp(hBUhINhWNhXhhCjjubaubj )rq}rr(hBU hCjHhIhJhKj¤hM}rs(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rthbX …ru}rv(hBUhINhWNhXhhCjqubaubeubj³)rw}rx(hBUhCj"hIhJhKj¶hM}ry(hO]hP]hQ]hR]hU]uhWNhXhhY]rz(j¹)r{}r|(hBUhCjwhIhJhKj¼hM}r}(hO]hP]hQ]hR]hU]uhWNhXhhY]r~jæ)r}r€(hBUhM}r(hO]hP]hQ]hR]hU]uhCj{hY]r‚(jÄ)rƒ}r„(hBX Default valuehCjhIhJhKjĒhM}r…(hO]hP]hQ]hR]hU]uhWKhY]r†hbX Default valuer‡…rˆ}r‰(hBUhCjƒubaubjĶ)rŠ}r‹(hBUhM}rŒ(hO]hP]hQ]hR]hU]uhCjhY]rhu)rŽ}r(hBX1hM}r(hO]hP]hQ]hR]hU]uhCjŠhY]r‘hbX1…r’}r“(hBX1hINhWNhXhhCjŽubahKhyubahKjŻubehKjŽubaubhu)r”}r•(hBXJControl the verbosity of ``cabal`` commands, valid values are from 0 to 3.hCjwhIhJhKhyhM}r–(hO]hP]hQ]hR]hU]uhWMhXhhY]r—(hbXControl the verbosity of r˜…r™}rš(hBXControl the verbosity of hINhWNhXhhCj”ubh›)r›}rœ(hBX ``cabal``hM}r(hO]hP]hQ]hR]hU]uhCj”hY]ržhbXcabalrŸ…r }r”(hBUhCj›ubahKh£ubhbX( commands, valid values are from 0 to 3.r¢…r£}r¤(hBX( commands, valid values are from 0 to 3.hINhWNhXhhCj”ubeubhu)r„}r¦(hBXbThe command line variant of this field is ``--verbose=2``; a short form ``-v2`` is also supported.hCjwhIhJhKhyhM}r§(hO]hP]hQ]hR]hU]uhWMhXhhY]rØ(hbX*The command line variant of this field is r©…rŖ}r«(hBX*The command line variant of this field is hINhWNhXhhCj„ubh›)r¬}r­(hBX``--verbose=2``hM}r®(hO]hP]hQ]hR]hU]uhCj„hY]rÆhbX --verbose=2r°…r±}r²(hBUhCj¬ubahKh£ubhbX; a short form r³…r“}rµ(hBX; a short form hINhWNhXhhCj„ubh›)r¶}r·(hBX``-v2``hM}rø(hO]hP]hQ]hR]hU]uhCj„hY]r¹hbX-v2rŗ…r»}r¼(hBUhCj¶ubahKh£ubhbX is also supported.r½…r¾}ræ(hBX is also supported.hINhWNhXhhCj„ubeubeubeubjw)rĄ}rĮ(hBUhCj hIhJhKjzhM}rĀ(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rĆ}rÄ(hBUhCj hIhJhKjhM}rÅ(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrĘj…jĘuhWNhXhhY]rĒ(j‡)rČ}rÉ(hBXjobs: nat or $ncpushCjĆhIhJhKjŠhM}rŹ(hR]rĖXcfg-field-jobsrĢahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĶ(jw)rĪ}rĻ(hBUhCjČhIhJhKjzhM}rŠ(hR]hQ]hO]hP]hU]Uentries]rŃ(j”Xjobs ; cabal project optionjĢUNtrŅauhWNhXhhY]ubj–)rÓ}rŌ(hBXjobsrÕhCjČhIhJhKjšhM}rÖ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r×hbXjobsrŲ…rŁ}rŚ(hBUhINhWNhXhhCjÓubaubj )rŪ}rÜ(hBj£hCjČhIhJhKj¤hM}rŻ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŽhbX: rß…rą}rį(hBUhINhWNhXhhCjŪubaubjŖ)rā}rć(hBX nat or $ncpushCjČhIhJhKj­hM}rä(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]råhbX nat or $ncpusrꅁrē}rč(hBUhINhWNhXhhCjāubaubeubj‡)ré}rź(hBX--jobs=n, -jn, --jobs=$ncpushCjĆhIhJhKjŠhM}rė(hR]rģXcfg-flag---jobsrķahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rī(jw)rļ}rš(hBUhCjéhIhJhKjzhM}rń(hR]hQ]hO]hP]hU]Uentries]rņ(j”X--jobs; cabal project optionjķUNtróauhWNhXhhY]ubj–)rō}rõ(hBX--jobsröhCjéhIhJhKjšhM}r÷(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rųhbX--jobsrł…rś}rū(hBUhINhWNhXhhCjōubaubj )rü}rż(hBX=nhCjéhIhJhKj¤hM}rž(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r’hbX=nr…r}r(hBUhINhWNhXhhCjüubaubj–)r}r(hBjdhCjéhIhJhKjšhM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX, r…r}r (hBUhINhWNhXhhCjubaubj–)r }r (hBX-jnhCjéhIhJhKjšhM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX-jnr…r}r(hBUhINhWNhXhhCj ubaubj )r}r(hBU hCjéhIhJhKj¤hM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX …r}r(hBUhINhWNhXhhCjubaubj–)r}r(hBjdhCjéhIhJhKjšhM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX, r…r}r(hBUhINhWNhXhhCjubaubj–)r}r(hBX--jobshCjéhIhJhKjšhM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r!hbX--jobsr"…r#}r$(hBUhINhWNhXhhCjubaubj )r%}r&(hBX=$ncpushCjéhIhJhKj¤hM}r'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r(hbX=$ncpusr)…r*}r+(hBUhINhWNhXhhCj%ubaubeubj³)r,}r-(hBUhCjĆhIhJhKj¶hM}r.(hO]hP]hQ]hR]hU]uhWNhXhhY]r/(j¹)r0}r1(hBUhCj,hIhJhKj¼hM}r2(hO]hP]hQ]hR]hU]uhWNhXhhY]r3jæ)r4}r5(hBUhM}r6(hO]hP]hQ]hR]hU]uhCj0hY]r7(jÄ)r8}r9(hBX Default valuehCj4hIhJhKjĒhM}r:(hO]hP]hQ]hR]hU]uhWKhY]r;hbX Default valuer<…r=}r>(hBUhCj8ubaubjĶ)r?}r@(hBUhM}rA(hO]hP]hQ]hR]hU]uhCj4hY]rBhu)rC}rD(hBX1hM}rE(hO]hP]hQ]hR]hU]uhCj?hY]rFhbX1…rG}rH(hBX1hINhWNhXhhCjCubahKhyubahKjŻubehKjŽubaubhu)rI}rJ(hBXę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!hCj,hIhJhKhyhM}rK(hO]hP]hQ]hR]hU]uhWMhXhhY]rL(hbXRun rM…rN}rO(hBXRun hINhWNhXhhCjIubjŖ)rP}rQ(hBX*nat*hM}rR(hO]hP]hQ]hR]hU]uhCjIhY]rShbXnatrT…rU}rV(hBUhCjPubahKj²ubhbX' jobs simultaneously when building. If rW…rX}rY(hBX' jobs simultaneously when building. If hINhWNhXhhCjIubh›)rZ}r[(hBX ``$ncpus``hM}r\(hO]hP]hQ]hR]hU]uhCjIhY]r]hbX$ncpusr^…r_}r`(hBUhCjZubahKh£ubhbX¬ 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!ra…rb}rc(hBX¬ 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!hINhWNhXhhCjIubeubhu)rd}re(hBXŸ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``.hCj,hIhJhKhyhM}rf(hO]hP]hQ]hR]hU]uhWM!hXhhY]rg(hbX*The command line variant of this field is rh…ri}rj(hBX*The command line variant of this field is hINhWNhXhhCjdubh›)rk}rl(hBX ``--jobs=2``hM}rm(hO]hP]hQ]hR]hU]uhCjdhY]rnhbX--jobs=2ro…rp}rq(hBUhCjkubahKh£ubhbX; a short form rr…rs}rt(hBX; a short form hINhWNhXhhCjdubh›)ru}rv(hBX``-j2``hM}rw(hO]hP]hQ]hR]hU]uhCjdhY]rxhbX-j2ry…rz}r{(hBUhCjuubahKh£ubhbX is also supported; a bare r|…r}}r~(hBX is also supported; a bare hINhWNhXhhCjdubh›)r}r€(hBX ``--jobs``hM}r(hO]hP]hQ]hR]hU]uhCjdhY]r‚hbX--jobsrƒ…r„}r…(hBUhCjubahKh£ubhbX or r†…r‡}rˆ(hBX or hINhWNhXhhCjdubh›)r‰}rŠ(hBX``-j``hM}r‹(hO]hP]hQ]hR]hU]uhCjdhY]rŒhbX-jr…rŽ}r(hBUhCj‰ubahKh£ubhbX is equivalent to r…r‘}r’(hBX is equivalent to hINhWNhXhhCjdubh›)r“}r”(hBX``--jobs=$ncpus``hM}r•(hO]hP]hQ]hR]hU]uhCjdhY]r–hbX --jobs=$ncpusr—…r˜}r™(hBUhCj“ubahKh£ubhbX.…rš}r›(hBX.hINhWNhXhhCjdubeubeubeubjw)rœ}r(hBUhCj hIhJhKjzhM}rž(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rŸ}r (hBUhCj hIhJhKjhM}r”(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr¢j…j¢uhWNhXhhY]r£(j‡)r¤}r„(hBXkeep-going: booleanhCjŸhIhJhKjŠhM}r¦(hR]r§Xcfg-field-keep-goingrØahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r©(jw)rŖ}r«(hBUhCj¤hIhJhKjzhM}r¬(hR]hQ]hO]hP]hU]Uentries]r­(j”X!keep-going ; cabal project optionjØUNtr®auhWNhXhhY]ubj–)rÆ}r°(hBX keep-goingr±hCj¤hIhJhKjšhM}r²(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r³hbX keep-goingr“…rµ}r¶(hBUhINhWNhXhhCjÆubaubj )r·}rø(hBj£hCj¤hIhJhKj¤hM}r¹(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗhbX: r»…r¼}r½(hBUhINhWNhXhhCj·ubaubjŖ)r¾}ræ(hBXbooleanhCj¤hIhJhKj­hM}rĄ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĮhbXbooleanrĀ…rĆ}rÄ(hBUhINhWNhXhhCj¾ubaubeubj‡)rÅ}rĘ(hBX --keep-goingrĒhCjŸhIhJhKjŠhM}rČ(hR]rÉXcfg-flag---keep-goingrŹahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĖ(jw)rĢ}rĶ(hBUhCjÅhIhJhKjzhM}rĪ(hR]hQ]hO]hP]hU]Uentries]rĻ(j”X"--keep-going; cabal project optionjŹUNtrŠauhWNhXhhY]ubj–)rŃ}rŅ(hBjĒhCjÅhIhJhKjšhM}rÓ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŌhbX --keep-goingrÕ…rÖ}r×(hBUhINhWNhXhhCjŃubaubj )rŲ}rŁ(hBU hCjÅhIhJhKj¤hM}rŚ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŪhbX …rÜ}rŻ(hBUhINhWNhXhhCjŲubaubeubj³)rŽ}rß(hBUhCjŸhIhJhKj¶hM}rą(hO]hP]hQ]hR]hU]uhWNhXhhY]rį(j¹)rā}rć(hBUhCjŽhIhJhKj¼hM}rä(hO]hP]hQ]hR]hU]uhWNhXhhY]råjæ)rę}rē(hBUhM}rč(hO]hP]hQ]hR]hU]uhCjāhY]ré(jÄ)rź}rė(hBX Default valuehCjęhIhJhKjĒhM}rģ(hO]hP]hQ]hR]hU]uhWKhY]rķhbX Default valuerī…rļ}rš(hBUhCjźubaubjĶ)rń}rņ(hBUhM}ró(hO]hP]hQ]hR]hU]uhCjęhY]rōhu)rõ}rö(hBXFalsehM}r÷(hO]hP]hQ]hR]hU]uhCjńhY]rųhbXFalserł…rś}rū(hBXFalsehINhWNhXhhCjõubahKhyubahKjŻubehKjŽubaubhu)rü}rż(hBXLIf true, after a build failure, continue to build other unaffected packages.ržhCjŽhIhJhKhyhM}r’(hO]hP]hQ]hR]hU]uhWM+hXhhY]rhbXLIf true, after a build failure, continue to build other unaffected packages.r…r}r(hBjžhINhWNhXhhCjüubaubhu)r}r(hBX;The command line variant of this field is ``--keep-going``.hCjŽhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM.hXhhY]r(hbX*The command line variant of this field is r…r }r (hBX*The command line variant of this field is hINhWNhXhhCjubh›)r }r (hBX``--keep-going``hM}r (hO]hP]hQ]hR]hU]uhCjhY]rhbX --keep-goingr…r}r(hBUhCj ubahKh£ubhbX.…r}r(hBX.hINhWNhXhhCjubeubeubeubjw)r}r(hBUhCj hIhJhKjzhM}r(hR]hQ]hO]hP]hU]Uentries]r(j”X#command line option; --builddir=DIRjį UNtrauhWNhXhhY]ubj|)r}r(hBUhCj hIhJhKjhM}r(j‰j‚XstdhR]hQ]hO]hP]hU]jƒXoptionrj…juhWNhXhhY]r(j‡)r}r(hBX--builddir=DIRhCjhIhJhKjŠhM}r (Uallnamesr!]r"X --builddirr#ahR]r$jį ahQ]hO]hP]hU]r%hajŽ‰uhWM9hXhhY]r&(j–)r'}r((hBj#hCjhIhJhKjšhM}r)(jŸj hR]hQ]hO]hP]hU]uhWM9hXhhY]r*hbX --builddirr+…r,}r-(hBUhINhWNhXhhCj'ubaubj )r.}r/(hBX=DIRhCjhIhJhKj¤hM}r0(jŸj hR]hQ]hO]hP]hU]uhWM9hXhhY]r1hbX=DIRr2…r3}r4(hBUhINhWNhXhhCj.ubaubeubj³)r5}r6(hBUhCjhIhJhKj¶hM}r7(hO]hP]hQ]hR]hU]uhWM9hXhhY]r8(hu)r9}r:(hBXSpecifies 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.)hCj5hIhJhKhyhM}r;(hO]hP]hQ]hR]hU]uhWM2hXhhY]r<(hbX_Specifies the name of the directory where build products for build will be stored; defaults to r=…r>}r?(hBX_Specifies the name of the directory where build products for build will be stored; defaults to hINhWNhXhhCj9ubh›)r@}rA(hBX``dist-newstyle``hM}rB(hO]hP]hQ]hR]hU]uhCj9hY]rChbX dist-newstylerD…rE}rF(hBUhCj@ubahKh£ubhbXt. If a relative name is specified, this directory is resolved relative to the root of the project (i.e., where the rG…rH}rI(hBXt. If a relative name is specified, this directory is resolved relative to the root of the project (i.e., where the hINhWNhXhhCj9ubh›)rJ}rK(hBX``cabal.project``hM}rL(hO]hP]hQ]hR]hU]uhCj9hY]rMhbX cabal.projectrN…rO}rP(hBUhCjJubahKh£ubhbX file lives.)rQ…rR}rS(hBX file lives.)hINhWNhXhhCj9ubeubhu)rT}rU(hBX=This option cannot be specified via a ``cabal.project`` file.hCj5hIhJhKhyhM}rV(hO]hP]hQ]hR]hU]uhWM8hXhhY]rW(hbX&This option cannot be specified via a rX…rY}rZ(hBX&This option cannot be specified via a hINhWNhXhhCjTubh›)r[}r\(hBX``cabal.project``hM}r](hO]hP]hQ]hR]hU]uhCjThY]r^hbX cabal.projectr_…r`}ra(hBUhCj[ubahKh£ubhbX file.rb…rc}rd(hBX file.hINhWNhXhhCjTubeubeubeubj€)re}rf(hBX.. _cmdoption-project-file:hCj hIhJhKj†hM}rg(hO]hP]hQ]hR]rhjŌ ahU]rih auhWM:hXhhY]ubjw)rj}rk(hBUhCj hIhJhKjzhM}rl(hR]hQ]hO]hP]hU]Uentries]rm(j”X(command line option; --project-file=FILEjŪ UNtrnauhWNhXhhY]ubj|)ro}rp(hBUhCj hIhJhKjhM}rq(j‰j‚XstdhR]hQ]hO]hP]hU]jƒXoptionrrj…jruhWNhXhhY]rs(j‡)rt}ru(hBX--project-file=FILEhCjohIhJhKjŠhM}rv(j!]rwX--project-filerxahR]ryjŪ ahQ]hO]hP]hU]rzhajŽ‰uhWMKhXhhY]r{(j–)r|}r}(hBjxhCjthIhJhKjšhM}r~(jŸj hR]hQ]hO]hP]hU]uhWMKhXhhY]rhbX--project-filer€…r}r‚(hBUhINhWNhXhhCj|ubaubj )rƒ}r„(hBX=FILEhCjthIhJhKj¤hM}r…(jŸj hR]hQ]hO]hP]hU]uhWMKhXhhY]r†hbX=FILEr‡…rˆ}r‰(hBUhINhWNhXhhCjƒubaubeubj³)rŠ}r‹(hBUhCjohIhJhKj¶hM}rŒ(hO]hP]hQ]hR]hU]uhWMKhXhhY]r(hu)rŽ}r(hBX±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``.hCjŠhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM=hXhhY]r‘(hbXlSpecifies the name of the project file used to specify the rest of the top-level configuration; defaults to r’…r“}r”(hBXlSpecifies the name of the project file used to specify the rest of the top-level configuration; defaults to hINhWNhXhhCjŽubh›)r•}r–(hBX``cabal.project``hM}r—(hO]hP]hQ]hR]hU]uhCjŽhY]r˜hbX cabal.projectr™…rš}r›(hBUhCj•ubahKh£ubhbXg. This name not only specifies the name of the main project file, but also the auxiliary project files rœ…r}rž(hBXg. This name not only specifies the name of the main project file, but also the auxiliary project files hINhWNhXhhCjŽubh›)rŸ}r (hBX``cabal.project.freeze``hM}r”(hO]hP]hQ]hR]hU]uhCjŽhY]r¢hbXcabal.project.freezer£…r¤}r„(hBUhCjŸubahKh£ubhbX and r¦…r§}rØ(hBX and hINhWNhXhhCjŽubh›)r©}rŖ(hBX``cabal.project.local``hM}r«(hO]hP]hQ]hR]hU]uhCjŽhY]r¬hbXcabal.project.localr­…r®}rÆ(hBUhCj©ubahKh£ubhbX; for example, if you specify r°…r±}r²(hBX; for example, if you specify hINhWNhXhhCjŽubh›)r³}r“(hBX``--project-file=my.project``hM}rµ(hO]hP]hQ]hR]hU]uhCjŽhY]r¶hbX--project-file=my.projectr·…rø}r¹(hBUhCj³ubahKh£ubhbX/, then the other files that will be probed are rŗ…r»}r¼(hBX/, then the other files that will be probed are hINhWNhXhhCjŽubh›)r½}r¾(hBX``my.project.freeze``hM}ræ(hO]hP]hQ]hR]hU]uhCjŽhY]rĄhbXmy.project.freezerĮ…rĀ}rĆ(hBUhCj½ubahKh£ubhbX and rÄ…rÅ}rĘ(hBX and hINhWNhXhhCjŽubh›)rĒ}rČ(hBX``my.project.local``hM}rÉ(hO]hP]hQ]hR]hU]uhCjŽhY]rŹhbXmy.project.localrĖ…rĢ}rĶ(hBUhCjĒubahKh£ubhbX.…rĪ}rĻ(hBX.hINhWNhXhhCjŽubeubhu)rŠ}rŃ(hBXī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.rŅhCjŠhIhJhKhyhM}rÓ(hO]hP]hQ]hR]hU]uhWMEhXhhY]rŌhbXš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.rÕ…rÖ}r×(hBjŅhINhWNhXhhCjŠubaubhu)rŲ}rŁ(hBX=This option cannot be specified via a ``cabal.project`` file.hCjŠhIhJhKhyhM}rŚ(hO]hP]hQ]hR]hU]uhWMJhXhhY]rŪ(hbX&This option cannot be specified via a rÜ…rŻ}rŽ(hBX&This option cannot be specified via a hINhWNhXhhCjŲubh›)rß}rą(hBX``cabal.project``hM}rį(hO]hP]hQ]hR]hU]uhCjŲhY]rāhbX cabal.projectr慁rä}rå(hBUhCjßubahKh£ubhbX file.rꅁrē}rč(hBX file.hINhWNhXhhCjŲubeubeubeubjw)ré}rź(hBUhCj hIhJhKjzhM}rė(hR]hQ]hO]hP]hU]Uentries]rģ(j”X$command line option; --store-dir=DIRjÕ UNtrķauhWNhXhhY]ubj|)rī}rļ(hBUhCj hIhJhKjhM}rš(j‰j‚XstdhR]hQ]hO]hP]hU]jƒXoptionrńj…jńuhWNhXhhY]rņ(j‡)ró}rō(hBX--store-dir=DIRhCjīhIhJhKjŠhM}rõ(j!]röX --store-dirr÷ahR]rųjÕ ahQ]hO]hP]hU]rłh ajŽ‰uhWMOhXhhY]rś(j–)rū}rü(hBj÷hCjóhIhJhKjšhM}rż(jŸj hR]hQ]hO]hP]hU]uhWMOhXhhY]ržhbX --store-dirr’…r}r(hBUhINhWNhXhhCjūubaubj )r}r(hBX=DIRhCjóhIhJhKj¤hM}r(jŸj hR]hQ]hO]hP]hU]uhWMOhXhhY]rhbX=DIRr…r}r(hBUhINhWNhXhhCjubaubeubj³)r }r (hBUhCjīhIhJhKj¶hM}r (hO]hP]hQ]hR]hU]uhWMOhXhhY]r hu)r }r(hBX@Specifies the name of the directory of the global package store.rhCj hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMNhXhhY]rhbX@Specifies the name of the directory of the global package store.r…r}r(hBjhINhWNhXhhCj ubaubaubeubeubhD)r}r(hBUhCjŖhIhJhKhLhM}r(hO]hP]hQ]hR]rj× ahU]rhauhWMQhXhhY]r(h[)r}r(hBXSolver configuration optionsrhCjhIhJhKh_hM}r(hO]hP]hQ]hR]hU]uhWMQhXhhY]rhbXSolver configuration optionsr …r!}r"(hBjhINhWNhXhhCjubaubhu)r#}r$(hBXEThe following settings control the behavior of the dependency solver:r%hCjhIhJhKhyhM}r&(hO]hP]hQ]hR]hU]uhWMShXhhY]r'hbXEThe following settings control the behavior of the dependency solver:r(…r)}r*(hBj%hINhWNhXhhCj#ubaubjw)r+}r,(hBUhCjhIhJhKjzhM}r-(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r.}r/(hBUhCjhIhJhKjhM}r0(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr1j…j1uhWNhXhhY]r2(j‡)r3}r4(hBX/constraints: constraints list (comma separated)hCj.hIhJhKjŠhM}r5(hR]r6Xcfg-field-constraintsr7ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r8(jw)r9}r:(hBUhCj3hIhJhKjzhM}r;(hR]hQ]hO]hP]hU]Uentries]r<(j”X"constraints ; cabal project optionj7UNtr=auhWNhXhhY]ubj–)r>}r?(hBX constraintsr@hCj3hIhJhKjšhM}rA(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rBhbX constraintsrC…rD}rE(hBUhINhWNhXhhCj>ubaubj )rF}rG(hBj£hCj3hIhJhKj¤hM}rH(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rIhbX: rJ…rK}rL(hBUhINhWNhXhhCjFubaubjŖ)rM}rN(hBX"constraints list (comma separated)hCj3hIhJhKj­hM}rO(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rPhbX"constraints list (comma separated)rQ…rR}rS(hBUhINhWNhXhhCjMubaubeubj‡)rT}rU(hBX--constraint="pkg >= 2.0"hCj.hIhJhKjŠhM}rV(hR]rWXcfg-flag---constraintrXahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rY(jw)rZ}r[(hBUhCjThIhJhKjzhM}r\(hR]hQ]hO]hP]hU]Uentries]r](j”X"--constraint; cabal project optionjXUNtr^auhWNhXhhY]ubj–)r_}r`(hBX --constraintrahCjThIhJhKjšhM}rb(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rchbX --constraintrd…re}rf(hBUhINhWNhXhhCj_ubaubj )rg}rh(hBX ="pkg > 2.0"hCjThIhJhKj¤hM}ri(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rjhbX ="pkg > 2.0"rk…rl}rm(hBUhINhWNhXhhCjgubaubeubj³)rn}ro(hBUhCj.hIhJhKj¶hM}rp(hO]hP]hQ]hR]hU]uhWNhXhhY]rq(hu)rr}rs(hBX~Add extra constraints to the version bounds, flag settings, and other properties a solver can pick for a package. For example:rthCjnhIhJhKhyhM}ru(hO]hP]hQ]hR]hU]uhWMYhXhhY]rvhbX~Add extra constraints to the version bounds, flag settings, and other properties a solver can pick for a package. For example:rw…rx}ry(hBjthINhWNhXhhCjrubaubjš)rz}r{(hBXconstraints: bar == 2.1hCjnhIhJhKjhM}r|(jŸj hR]hQ]hO]hP]hU]uhWM_hXhhY]r}hbXconstraints: bar == 2.1r~…r}r€(hBUhCjzubaubhu)r}r‚(hBX&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:hCjnhIhJhKhyhM}rƒ(hO]hP]hQ]hR]hU]uhWMahXhhY]r„(hbX-A package can be specified multiple times in r……r†}r‡(hBX-A package can be specified multiple times in hINhWNhXhhCjubh›)rˆ}r‰(hBX``constraints``hM}rŠ(hO]hP]hQ]hR]hU]uhCjhY]r‹hbX constraintsrŒ…r}rŽ(hBUhCjˆubahKh£ubhbXź, 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‘(hBXź, 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:hINhWNhXhhCjubeubjš)r’}r“(hBX3constraints: bar == 2.1, bar +foo -bazhCjnhIhJhKjhM}r”(jŸj hR]hQ]hO]hP]hU]uhWMihXhhY]r•hbX3constraints: bar == 2.1, bar +foo -bazr–…r—}r˜(hBUhCj’ubaubhu)r™}rš(hBX“Valid constraints take the same form as for the `constraint command line option `__.hCjnhIhJhKhyhM}r›(hO]hP]hQ]hR]hU]uhWMlhXhhY]rœ(hbX0Valid constraints take the same form as for the r…rž}rŸ(hBX0Valid constraints take the same form as for the hINhWNhXhhCj™ubji)r }r”(hBXb`constraint command line option `__hM}r¢(UnameXconstraint command line optionjmX=installing-packages.html#cmdoption-setup-configure-constrainthR]hQ]hO]hP]hU]uhCj™hY]r£hbXconstraint command line optionr¤…r„}r¦(hBUhCj ubahKjrubhbX.…r§}rØ(hBX.hINhWNhXhhCj™ubeubeubeubjw)r©}rŖ(hBUhCjhIhJhKjzhM}r«(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r¬}r­(hBUhCjhIhJhKjhM}r®(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÆj…jÆuhWNhXhhY]r°(j‡)r±}r²(hBX)preferences: preference (comma separated)hCj¬hIhJhKjŠhM}r³(hR]r“Xcfg-field-preferencesrµahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r¶(jw)r·}rø(hBUhCj±hIhJhKjzhM}r¹(hR]hQ]hO]hP]hU]Uentries]rŗ(j”X"preferences ; cabal project optionjµUNtr»auhWNhXhhY]ubj–)r¼}r½(hBX preferencesr¾hCj±hIhJhKjšhM}ræ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĄhbX preferencesrĮ…rĀ}rĆ(hBUhINhWNhXhhCj¼ubaubj )rÄ}rÅ(hBj£hCj±hIhJhKj¤hM}rĘ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĒhbX: rČ…rÉ}rŹ(hBUhINhWNhXhhCjÄubaubjŖ)rĖ}rĢ(hBXpreference (comma separated)hCj±hIhJhKj­hM}rĶ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĪhbXpreference (comma separated)rĻ…rŠ}rŃ(hBUhINhWNhXhhCjĖubaubeubj‡)rŅ}rÓ(hBX--preference="pkg >= 2.0"hCj¬hIhJhKjŠhM}rŌ(hR]rÕXcfg-flag---preferencerÖahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r×(jw)rŲ}rŁ(hBUhCjŅhIhJhKjzhM}rŚ(hR]hQ]hO]hP]hU]Uentries]rŪ(j”X"--preference; cabal project optionjÖUNtrÜauhWNhXhhY]ubj–)rŻ}rŽ(hBX --preferencerßhCjŅhIhJhKjšhM}rą(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rįhbX --preferencerā…rć}rä(hBUhINhWNhXhhCjŻubaubj )rå}rę(hBX ="pkg > 2.0"hCjŅhIhJhKj¤hM}rē(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rčhbX ="pkg > 2.0"r酁rź}rė(hBUhINhWNhXhhCjåubaubeubj³)rģ}rķ(hBUhCj¬hIhJhKj¶hM}rī(hO]hP]hQ]hR]hU]uhWNhXhhY]rļ(hu)rš}rń(hBX0Like :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.hCjģhIhJhKhyhM}rņ(hO]hP]hQ]hR]hU]uhWMthXhhY]ró(hbXLike rō…rõ}rö(hBXLike hINhWNhXhhCjšubj[)r÷}rų(hBX:cfg-field:`constraints`rłhCjšhIhJhKj_hM}rś(UreftypeX cfg-fieldjaˆjbX constraintsU refdomainXcabalrūhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMthY]rüh›)rż}rž(hBjłhM}r’(hO]hP]r(jljūXcabal-cfg-fieldrehQ]hR]hU]uhCj÷hY]rhbX constraintsr…r}r(hBUhCjżubahKh£ubaubhbX, 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.r…r}r(hBX, 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.hINhWNhXhhCjšubeubhu)r }r (hBX›Operationally, preferences can cause the solver to attempt certain version choices of a package before others, which can improve dependency solver runtime.r hCjģhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMzhXhhY]r hbX›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(hBj hINhWNhXhhCj ubaubhu)r}r(hBX^One way to use :cfg-field:`preferences` is to take a known working set of constraints (e.g., via ``cabal new-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.hCjģhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM~hXhhY]r(hbXOne way to use r…r}r(hBXOne way to use hINhWNhXhhCjubj[)r}r(hBX:cfg-field:`preferences`rhCjhIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbX preferencesU refdomainXcabalrhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM~hY]rh›)r}r(hBjhM}r (hO]hP]r!(jljXcabal-cfg-fieldr"ehQ]hR]hU]uhCjhY]r#hbX preferencesr$…r%}r&(hBUhCjubahKh£ubaubhbX: is to take a known working set of constraints (e.g., via r'…r(}r)(hBX: is to take a known working set of constraints (e.g., via hINhWNhXhhCjubh›)r*}r+(hBX``cabal new-freeze``hM}r,(hO]hP]hQ]hR]hU]uhCjhY]r-hbXcabal new-freezer.…r/}r0(hBUhCj*ubahKh£ubhbXé) 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.r1…r2}r3(hBXé) 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.hINhWNhXhhCjubeubhu)r4}r5(hBX‡The command line variant of this field is ``--preference="pkg >= 2.0"``; to specify multiple preferences, pass the flag multiple times.hCjģhIhJhKhyhM}r6(hO]hP]hQ]hR]hU]uhWM…hXhhY]r7(hbX*The command line variant of this field is r8…r9}r:(hBX*The command line variant of this field is hINhWNhXhhCj4ubh›)r;}r<(hBX``--preference="pkg >= 2.0"``hM}r=(hO]hP]hQ]hR]hU]uhCj4hY]r>hbX--preference="pkg >= 2.0"r?…r@}rA(hBUhCj;ubahKh£ubhbX@; to specify multiple preferences, pass the flag multiple times.rB…rC}rD(hBX@; to specify multiple preferences, pass the flag multiple times.hINhWNhXhhCj4ubeubeubeubjw)rE}rF(hBUhCjhIhJhKjzhM}rG(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rH}rI(hBUhCjhIhJhKjhM}rJ(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrKj…jKuhWNhXhhY]rL(j‡)rM}rN(hBXQallow-newer: none, all or list of scoped package names (space or comma separated)hCjHhIhJhKjŠhM}rO(hR]rPXcfg-field-allow-newerrQahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rR(jw)rS}rT(hBUhCjMhIhJhKjzhM}rU(hR]hQ]hO]hP]hU]Uentries]rV(j”X"allow-newer ; cabal project optionjQUNtrWauhWNhXhhY]ubj–)rX}rY(hBX allow-newerrZhCjMhIhJhKjšhM}r[(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r\hbX allow-newerr]…r^}r_(hBUhINhWNhXhhCjXubaubj )r`}ra(hBj£hCjMhIhJhKj¤hM}rb(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rchbX: rd…re}rf(hBUhINhWNhXhhCj`ubaubjŖ)rg}rh(hBXDnone, all or list of scoped package names (space or comma separated)hCjMhIhJhKj­hM}ri(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rjhbXDnone, all or list of scoped package names (space or comma separated)rk…rl}rm(hBUhINhWNhXhhCjgubaubeubj‡)rn}ro(hBX6--allow-newer, --allow-newer=[none,all,[scope:][^]pkg]hCjHhIhJhKjŠhM}rp(hR]rqXcfg-flag---allow-newerrrahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rs(jw)rt}ru(hBUhCjnhIhJhKjzhM}rv(hR]hQ]hO]hP]hU]Uentries]rw(j”X#--allow-newer; cabal project optionjrUNtrxauhWNhXhhY]ubj–)ry}rz(hBX --allow-newerr{hCjnhIhJhKjšhM}r|(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r}hbX --allow-newerr~…r}r€(hBUhINhWNhXhhCjyubaubj )r}r‚(hBU hCjnhIhJhKj¤hM}rƒ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r„hbX …r…}r†(hBUhINhWNhXhhCjubaubj–)r‡}rˆ(hBjdhCjnhIhJhKjšhM}r‰(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠhbX, r‹…rŒ}r(hBUhINhWNhXhhCj‡ubaubj–)rŽ}r(hBX --allow-newerhCjnhIhJhKjšhM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‘hbX --allow-newerr’…r“}r”(hBUhINhWNhXhhCjŽubaubj )r•}r–(hBX=[nonehCjnhIhJhKj¤hM}r—(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r˜hbX=[noner™…rš}r›(hBUhINhWNhXhhCj•ubaubj–)rœ}r(hBjdhCjnhIhJhKjšhM}rž(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŸhbX, r …r”}r¢(hBUhINhWNhXhhCjœubaubj–)r£}r¤(hBXallhCjnhIhJhKjšhM}r„(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¦hbXallr§…rØ}r©(hBUhINhWNhXhhCj£ubaubj )rŖ}r«(hBU hCjnhIhJhKj¤hM}r¬(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r­hbX …r®}rÆ(hBUhINhWNhXhhCjŖubaubj–)r°}r±(hBjdhCjnhIhJhKjšhM}r²(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r³hbX, r“…rµ}r¶(hBUhINhWNhXhhCj°ubaubj–)r·}rø(hBX[scope:][^]pkg]hCjnhIhJhKjšhM}r¹(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗhbX[scope:][^]pkg]r»…r¼}r½(hBUhINhWNhXhhCj·ubaubj )r¾}ræ(hBU hCjnhIhJhKj¤hM}rĄ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĮhbX …rĀ}rĆ(hBUhINhWNhXhhCj¾ubaubeubj³)rÄ}rÅ(hBUhCjHhIhJhKj¶hM}rĘ(hO]hP]hQ]hR]hU]uhWNhXhhY]rĒ(j¹)rČ}rÉ(hBUhCjÄhIhJhKj¼hM}rŹ(hO]hP]hQ]hR]hU]uhWNhXhhY]rĖjæ)rĢ}rĶ(hBUhM}rĪ(hO]hP]hQ]hR]hU]uhCjČhY]rĻ(jÄ)rŠ}rŃ(hBX Default valuehCjĢhIhJhKjĒhM}rŅ(hO]hP]hQ]hR]hU]uhWKhY]rÓhbX Default valuerŌ…rÕ}rÖ(hBUhCjŠubaubjĶ)r×}rŲ(hBUhM}rŁ(hO]hP]hQ]hR]hU]uhCjĢhY]rŚhu)rŪ}rÜ(hBXnonehM}rŻ(hO]hP]hQ]hR]hU]uhCj×hY]rŽh›)rß}rą(hBX``none``hCjŪhIhJhKh£hM}rį(hO]hP]hQ]hR]hU]uhWNhXhhY]rāhbXnoner慁rä}rå(hBUhINhWNhXhhCjßubaubahKhyubahKjŻubehKjŽubaubhu)rę}rē(hBX 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.hCjÄhIhJhKhyhM}rč(hO]hP]hQ]hR]hU]uhWMhXhhY]ré(hbXhAllow the solver to pick an newer version of some packages than would normally be permitted by than the rź…rė}rģ(hBXhAllow the solver to pick an newer version of some packages than would normally be permitted by than the hINhWNhXhhCjęubj[)rķ}rī(hBX:pkg-field:`build-depends`rļhCjęhIhJhKj_hM}rš(UreftypeX pkg-fieldjaˆjbX build-dependsU refdomainXcabalrńhR]hQ]U refexplicit‰hO]hP]hU]jdjeUcabal:pkg-sectionrņNuhWMhY]róh›)rō}rõ(hBjļhM}rö(hO]hP]r÷(jljńXcabal-pkg-fieldrųehQ]hR]hU]uhCjķhY]rłhbX build-dependsrś…rū}rü(hBUhCjōubahKh£ubaubhbX‡ bounds of packages in the install plan. This option may be useful if the dependency solver cannot otherwise find a valid install plan.rż…rž}r’(hBX‡ bounds of packages in the install plan. This option may be useful if the dependency solver cannot otherwise find a valid install plan.hINhWNhXhhCjęubeubhu)r}r(hBX€For example, to relax ``pkg``\ s :pkg-field:`build-depends` upper bound on ``dep-pkg``, write a scoped package name of the form:hCjÄhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM”hXhhY]r(hbXFor example, to relax r…r}r(hBXFor example, to relax hINhWNhXhhCjubh›)r}r(hBX``pkg``hM}r (hO]hP]hQ]hR]hU]uhCjhY]r hbXpkgr …r }r (hBUhCjubahKh£ubhbXs r…r}r(hBX\ s hINhWNhXhhCjubj[)r}r(hBX:pkg-field:`build-depends`rhCjhIhJhKj_hM}r(UreftypeX pkg-fieldjaˆjbX build-dependsU refdomainXcabalrhR]hQ]U refexplicit‰hO]hP]hU]jdjejņNuhWM”hY]rh›)r}r(hBjhM}r(hO]hP]r(jljXcabal-pkg-fieldrehQ]hR]hU]uhCjhY]rhbX build-dependsr…r}r(hBUhCjubahKh£ubaubhbX upper bound on r …r!}r"(hBX upper bound on hINhWNhXhhCjubh›)r#}r$(hBX ``dep-pkg``hM}r%(hO]hP]hQ]hR]hU]uhCjhY]r&hbXdep-pkgr'…r(}r)(hBUhCj#ubahKh£ubhbX*, write a scoped package name of the form:r*…r+}r,(hBX*, write a scoped package name of the form:hINhWNhXhhCjubeubjš)r-}r.(hBXallow-newer: pkg:dep-pkghCjÄhIhJhKjhM}r/(jŸj hR]hQ]hO]hP]hU]uhWM™hXhhY]r0hbXallow-newer: pkg:dep-pkgr1…r2}r3(hBUhCj-ubaubhu)r4}r5(hBXVIf the scope shall be limited to specific releases of ``pkg``, the extended form as inhCjÄhIhJhKhyhM}r6(hO]hP]hQ]hR]hU]uhWM›hXhhY]r7(hbX6If the scope shall be limited to specific releases of r8…r9}r:(hBX6If the scope shall be limited to specific releases of hINhWNhXhhCj4ubh›)r;}r<(hBX``pkg``hM}r=(hO]hP]hQ]hR]hU]uhCj4hY]r>hbXpkgr?…r@}rA(hBUhCj;ubahKh£ubhbX, the extended form as inrB…rC}rD(hBX, the extended form as inhINhWNhXhhCj4ubeubjš)rE}rF(hBX1allow-newer: pkg-1.2.3:dep-pkg, pkg-1.1.2:dep-pkghCjÄhIhJhKjhM}rG(jŸj hR]hQ]hO]hP]hU]uhWM hXhhY]rHhbX1allow-newer: pkg-1.2.3:dep-pkg, pkg-1.1.2:dep-pkgrI…rJ}rK(hBUhCjEubaubhu)rL}rM(hBXxcan be used to limit the relaxation of dependencies on ``dep-pkg`` by the ``pkg-1.2.3`` and ``pkg-1.1.2`` releases only.hCjÄhIhJhKhyhM}rN(hO]hP]hQ]hR]hU]uhWM¢hXhhY]rO(hbX7can be used to limit the relaxation of dependencies on rP…rQ}rR(hBX7can be used to limit the relaxation of dependencies on hINhWNhXhhCjLubh›)rS}rT(hBX ``dep-pkg``hM}rU(hO]hP]hQ]hR]hU]uhCjLhY]rVhbXdep-pkgrW…rX}rY(hBUhCjSubahKh£ubhbX by the rZ…r[}r\(hBX by the hINhWNhXhhCjLubh›)r]}r^(hBX ``pkg-1.2.3``hM}r_(hO]hP]hQ]hR]hU]uhCjLhY]r`hbX pkg-1.2.3ra…rb}rc(hBUhCj]ubahKh£ubhbX and rd…re}rf(hBX and hINhWNhXhhCjLubh›)rg}rh(hBX ``pkg-1.1.2``hM}ri(hO]hP]hQ]hR]hU]uhCjLhY]rjhbX pkg-1.1.2rk…rl}rm(hBUhCjgubahKh£ubhbX releases only.rn…ro}rp(hBX releases only.hINhWNhXhhCjLubeubhu)rq}rr(hBXThe 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.rshCjÄhIhJhKhyhM}rt(hO]hP]hQ]hR]hU]uhWM„hXhhY]ruhbXThe 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.rv…rw}rx(hBjshINhWNhXhhCjqubaubhu)ry}rz(hBX\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.hCjÄhIhJhKhyhM}r{(hO]hP]hQ]hR]hU]uhWMŖhXhhY]r|(hbXÕ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(hBXÕ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. hINhWNhXhhCjyubh›)r€}r(hBX``^``hM}r‚(hO]hP]hQ]hR]hU]uhCjyhY]rƒhbX^…r„}r…(hBUhCj€ubahKh£ubhbX@ (i.e. caret) which causes the relaxation to be applied only to r†…r‡}rˆ(hBX@ (i.e. caret) which causes the relaxation to be applied only to hINhWNhXhhCjyubh›)r‰}rŠ(hBX``^>=``hM}r‹(hO]hP]hQ]hR]hU]uhCjyhY]rŒhbX^>=r…rŽ}r(hBUhCj‰ubahKh£ubhbX; operators and leave all other version operators untouched.r…r‘}r’(hBX; operators and leave all other version operators untouched.hINhWNhXhhCjyubeubhu)r“}r”(hBX!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:hCjÄhIhJhKhyhM}r•(hO]hP]hQ]hR]hU]uhWM±hXhhY]r–(hbXyHowever, in some situations (e.g., when attempting to build packages on a new version of GHC), it is useful to disregard r—…r˜}r™(hBXyHowever, in some situations (e.g., when attempting to build packages on a new version of GHC), it is useful to disregard hINhWNhXhhCj“ubjŖ)rš}r›(hBX*all*hM}rœ(hO]hP]hQ]hR]hU]uhCj“hY]rhbXallrž…rŸ}r (hBUhCjšubahKj²ubhbXƒ 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£(hBXƒ upper-bounds, with respect to a package or all packages. This can be done by specifying just a package name, or using the keyword hINhWNhXhhCj“ubh›)r¤}r„(hBX``all``hM}r¦(hO]hP]hQ]hR]hU]uhCj“hY]r§hbXallrØ…r©}rŖ(hBUhCj¤ubahKh£ubhbX to specify all packages:r«…r¬}r­(hBX to specify all packages:hINhWNhXhhCj“ubeubjš)r®}rÆ(hBXF-- 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: ^allhCjÄhIhJhKjhM}r°(jŸj hR]hQ]hO]hP]hU]uhWM¹hXhhY]r±hbXF-- 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“(hBUhCj®ubaubhu)rµ}r¶(hBXæ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:hCjÄhIhJhKhyhM}r·(hO]hP]hQ]hR]hU]uhWMÅhXhhY]rø(hbXBFor consistency, there is also the explicit wildcard scope syntax r¹…rŗ}r»(hBXBFor consistency, there is also the explicit wildcard scope syntax hINhWNhXhhCjµubh›)r¼}r½(hBX``*``hM}r¾(hO]hP]hQ]hR]hU]uhCjµhY]ræhbX*…rĄ}rĮ(hBUhCj¼ubahKh£ubhbX (or its alphabetic synonym rĀ…rĆ}rÄ(hBX (or its alphabetic synonym hINhWNhXhhCjµubh›)rÅ}rĘ(hBX``all``hM}rĒ(hO]hP]hQ]hR]hU]uhCjµhY]rČhbXallrÉ…rŹ}rĖ(hBUhCjÅubahKh£ubhbXU). Consequently, the examples above are equivalent to the explicitly scoped variants:rĢ…rĶ}rĪ(hBXU). Consequently, the examples above are equivalent to the explicitly scoped variants:hINhWNhXhhCjµubeubjš)rĻ}rŠ(hBXtallow-newer: all:bar, *:baz, *:^quux allow-newer: *:* allow-newer: all:all allow-newer: *:^* allow-newer: all:^allhCjÄhIhJhKjhM}rŃ(jŸj hR]hQ]hO]hP]hU]uhWMĖhXhhY]rŅhbXtallow-newer: all:bar, *:baz, *:^quux allow-newer: *:* allow-newer: all:all allow-newer: *:^* allow-newer: all:^allrÓ…rŌ}rÕ(hBUhCjĻubaubhu)rÖ}r×(hBX‚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 sohCjÄhIhJhKhyhM}rŲ(hO]hP]hQ]hR]hU]uhWMÓhXhhY]rŁ(hbX5In order to ignore all bounds specified by a package rŚ…rŪ}rÜ(hBX5In order to ignore all bounds specified by a package hINhWNhXhhCjÖubh›)rŻ}rŽ(hBX ``pkg-1.2.3``hM}rß(hO]hP]hQ]hR]hU]uhCjÖhY]rąhbX pkg-1.2.3rį…rā}rć(hBUhCjŻubahKh£ubhbX@ you can combine scoping with a right-hand-side wildcard like sor䅁rå}rę(hBX@ you can combine scoping with a right-hand-side wildcard like sohINhWNhXhhCjÖubeubjš)rē}rč(hBX -- 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:^*hCjÄhIhJhKjhM}ré(jŸj hR]hQ]hO]hP]hU]uhWMŲhXhhY]rźhbX -- 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ķ(hBUhCjēubaubhu)rī}rļ(hBX«: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.hCjÄhIhJhKhyhM}rš(hO]hP]hQ]hR]hU]uhWMßhXhhY]rń(j[)rņ}ró(hBX:cfg-field:`allow-newer`rōhCjīhIhJhKj_hM}rõ(UreftypeX cfg-fieldjaˆjbX allow-newerU refdomainXcabalröhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMßhY]r÷h›)rų}rł(hBjōhM}rś(hO]hP]rū(jljöXcabal-cfg-fieldrüehQ]hR]hU]uhCjņhY]rżhbX allow-newerrž…r’}r(hBUhCjųubahKh£ubaubhbXB is often used in conjunction with a constraint (in the cfg-field:r…r}r(hBXB is often used in conjunction with a constraint (in the cfg-field:hINhWNhXhhCjīubjƒ)r}r(hBX `constraints`hM}r(hO]hP]hQ]hR]hU]uhCjīhY]rhbX constraintsr…r }r (hBUhCjubahKj‹ubhbXD field) forcing the usage of a specific, newer version of a package.r …r }r (hBXD field) forcing the usage of a specific, newer version of a package.hINhWNhXhhCjīubeubhu)r}r(hBX†The command line variant of this field is e.g. ``--allow-newer=bar``. A bare ``--allow-newer`` is equivalent to ``--allow-newer=all``.hCjÄhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMćhXhhY]r(hbX/The command line variant of this field is e.g. r…r}r(hBX/The command line variant of this field is e.g. hINhWNhXhhCjubh›)r}r(hBX``--allow-newer=bar``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbX--allow-newer=barr…r}r(hBUhCjubahKh£ubhbX . A bare r…r}r(hBX . A bare hINhWNhXhhCjubh›)r}r (hBX``--allow-newer``hM}r!(hO]hP]hQ]hR]hU]uhCjhY]r"hbX --allow-newerr#…r$}r%(hBUhCjubahKh£ubhbX is equivalent to r&…r'}r((hBX is equivalent to hINhWNhXhhCjubh›)r)}r*(hBX``--allow-newer=all``hM}r+(hO]hP]hQ]hR]hU]uhCjhY]r,hbX--allow-newer=allr-…r.}r/(hBUhCj)ubahKh£ubhbX.…r0}r1(hBX.hINhWNhXhhCjubeubeubeubjw)r2}r3(hBUhCjhIhJhKjzhM}r4(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r5}r6(hBUhCjhIhJhKjhM}r7(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr8j…j8uhWNhXhhY]r9(j‡)r:}r;(hBXOallow-older: none, all, list of scoped package names (space or comma separated)hCj5hIhJhKjŠhM}r<(hR]r=Xcfg-field-allow-olderr>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r?(jw)r@}rA(hBUhCj:hIhJhKjzhM}rB(hR]hQ]hO]hP]hU]Uentries]rC(j”X"allow-older ; cabal project optionj>UNtrDauhWNhXhhY]ubj–)rE}rF(hBX allow-olderrGhCj:hIhJhKjšhM}rH(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rIhbX allow-olderrJ…rK}rL(hBUhINhWNhXhhCjEubaubj )rM}rN(hBj£hCj:hIhJhKj¤hM}rO(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rPhbX: rQ…rR}rS(hBUhINhWNhXhhCjMubaubjŖ)rT}rU(hBXBnone, all, list of scoped package names (space or comma separated)hCj:hIhJhKj­hM}rV(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rWhbXBnone, all, list of scoped package names (space or comma separated)rX…rY}rZ(hBUhINhWNhXhhCjTubaubeubj‡)r[}r\(hBX6--allow-older, --allow-older=[none,all,[scope:][^]pkg]hCj5hIhJhKjŠhM}r](hR]r^Xcfg-flag---allow-olderr_ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r`(jw)ra}rb(hBUhCj[hIhJhKjzhM}rc(hR]hQ]hO]hP]hU]Uentries]rd(j”X#--allow-older; cabal project optionj_UNtreauhWNhXhhY]ubj–)rf}rg(hBX --allow-olderrhhCj[hIhJhKjšhM}ri(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rjhbX --allow-olderrk…rl}rm(hBUhINhWNhXhhCjfubaubj )rn}ro(hBU hCj[hIhJhKj¤hM}rp(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rqhbX …rr}rs(hBUhINhWNhXhhCjnubaubj–)rt}ru(hBjdhCj[hIhJhKjšhM}rv(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rwhbX, rx…ry}rz(hBUhINhWNhXhhCjtubaubj–)r{}r|(hBX --allow-olderhCj[hIhJhKjšhM}r}(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r~hbX --allow-olderr…r€}r(hBUhINhWNhXhhCj{ubaubj )r‚}rƒ(hBX=[nonehCj[hIhJhKj¤hM}r„(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r…hbX=[noner†…r‡}rˆ(hBUhINhWNhXhhCj‚ubaubj–)r‰}rŠ(hBjdhCj[hIhJhKjšhM}r‹(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŒhbX, r…rŽ}r(hBUhINhWNhXhhCj‰ubaubj–)r}r‘(hBXallhCj[hIhJhKjšhM}r’(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“hbXallr”…r•}r–(hBUhINhWNhXhhCjubaubj )r—}r˜(hBU hCj[hIhJhKj¤hM}r™(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ršhbX …r›}rœ(hBUhINhWNhXhhCj—ubaubj–)r}rž(hBjdhCj[hIhJhKjšhM}rŸ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX, r”…r¢}r£(hBUhINhWNhXhhCjubaubj–)r¤}r„(hBX[scope:][^]pkg]hCj[hIhJhKjšhM}r¦(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§hbX[scope:][^]pkg]rØ…r©}rŖ(hBUhINhWNhXhhCj¤ubaubj )r«}r¬(hBU hCj[hIhJhKj¤hM}r­(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r®hbX …rÆ}r°(hBUhINhWNhXhhCj«ubaubeubj³)r±}r²(hBUhCj5hIhJhKj¶hM}r³(hO]hP]hQ]hR]hU]uhWNhXhhY]r“(j¹)rµ}r¶(hBUhCj±hIhJhKj¼hM}r·(hO]hP]hQ]hR]hU]uhWNhXhhY]rø(jæ)r¹}rŗ(hBUhCjµhIhJhKjŽhM}r»(hO]hP]hQ]hR]hU]uhWNhXhhY]r¼(jÄ)r½}r¾(hBUSinceræhCj¹hIhJhKjĒhM}rĄ(hO]hP]hQ]hR]hU]uhWKhY]rĮhbXSincerĀ…rĆ}rÄ(hBUhCj½ubaubjĶ)rÅ}rĘ(hBU Cabal 2.0rĒhM}rČ(hO]hP]hQ]hR]hU]uhCj¹hY]rÉhu)rŹ}rĖ(hBjĒhM}rĢ(hO]hP]hQ]hR]hU]uhCjÅhY]rĶhbX Cabal 2.0rĪ…rĻ}rŠ(hBUhCjŹubahKhyubahKjŻubeubjæ)rŃ}rŅ(hBUhM}rÓ(hO]hP]hQ]hR]hU]uhCjµhY]rŌ(jÄ)rÕ}rÖ(hBX Default valuehCjŃhIhJhKjĒhM}r×(hO]hP]hQ]hR]hU]uhWKhY]rŲhbX Default valuerŁ…rŚ}rŪ(hBUhCjÕubaubjĶ)rÜ}rŻ(hBUhM}rŽ(hO]hP]hQ]hR]hU]uhCjŃhY]rßhu)rą}rį(hBXnonehM}rā(hO]hP]hQ]hR]hU]uhCjÜhY]rćh›)rä}rå(hBX``none``hCjąhIhJhKh£hM}rę(hO]hP]hQ]hR]hU]uhWNhXhhY]rēhbXnoner腁ré}rź(hBUhINhWNhXhhCjäubaubahKhyubahKjŻubehKjŽubeubhu)rė}rģ(hBXTLike :cfg-field:`allow-newer`, but applied to lower bounds rather than upper bounds.hCj±hIhJhKhyhM}rķ(hO]hP]hQ]hR]hU]uhWMķhXhhY]rī(hbXLike rļ…rš}rń(hBXLike hINhWNhXhhCjėubj[)rņ}ró(hBX:cfg-field:`allow-newer`rōhCjėhIhJhKj_hM}rõ(UreftypeX cfg-fieldjaˆjbX allow-newerU refdomainXcabalröhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMķhY]r÷h›)rų}rł(hBjōhM}rś(hO]hP]rū(jljöXcabal-cfg-fieldrüehQ]hR]hU]uhCjņhY]rżhbX allow-newerrž…r’}r(hBUhCjųubahKh£ubaubhbX7, but applied to lower bounds rather than upper bounds.r…r}r(hBX7, but applied to lower bounds rather than upper bounds.hINhWNhXhhCjėubeubhu)r}r(hBXThe command line variant of this field is ``--allow-older=all``. A bare ``--allow-older`` is equivalent to ``--allow-older=all``.hCj±hIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMšhXhhY]r(hbX*The command line variant of this field is r…r }r (hBX*The command line variant of this field is hINhWNhXhhCjubh›)r }r (hBX``--allow-older=all``hM}r (hO]hP]hQ]hR]hU]uhCjhY]rhbX--allow-older=allr…r}r(hBUhCj ubahKh£ubhbX . A bare r…r}r(hBX . A bare hINhWNhXhhCjubh›)r}r(hBX``--allow-older``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbX --allow-olderr…r}r(hBUhCjubahKh£ubhbX is equivalent to r…r}r(hBX is equivalent to hINhWNhXhhCjubh›)r}r (hBX``--allow-older=all``hM}r!(hO]hP]hQ]hR]hU]uhCjhY]r"hbX--allow-older=allr#…r$}r%(hBUhCjubahKh£ubhbX.…r&}r'(hBX.hINhWNhXhhCjubeubeubeubjw)r(}r)(hBUhCjhIhJhKjzhM}r*(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r+}r,(hBUhCjhIhJhKjhM}r-(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr.j…j.uhWNhXhhY]r/(j‡)r0}r1(hBX9index-state: HEAD, unix-timestamp, ISO8601 UTC timestamp.hCj+hIhJhKjŠhM}r2(hR]r3Xcfg-field-index-stater4ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r5(jw)r6}r7(hBUhCj0hIhJhKjzhM}r8(hR]hQ]hO]hP]hU]Uentries]r9(j”X"index-state ; cabal project optionj4UNtr:auhWNhXhhY]ubj–)r;}r<(hBX index-stater=hCj0hIhJhKjšhM}r>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r?hbX index-stater@…rA}rB(hBUhINhWNhXhhCj;ubaubj )rC}rD(hBj£hCj0hIhJhKj¤hM}rE(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rFhbX: rG…rH}rI(hBUhINhWNhXhhCjCubaubjŖ)rJ}rK(hBX,HEAD, unix-timestamp, ISO8601 UTC timestamp.hCj0hIhJhKj­hM}rL(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rMhbX,HEAD, unix-timestamp, ISO8601 UTC timestamp.rN…rO}rP(hBUhINhWNhXhhCjJubaubeubj³)rQ}rR(hBUhCj+hIhJhKj¶hM}rS(hO]hP]hQ]hR]hU]uhWNhXhhY]rT(j¹)rU}rV(hBUhCjQhIhJhKj¼hM}rW(hO]hP]hQ]hR]hU]uhWNhXhhY]rX(jæ)rY}rZ(hBUhCjUhIhJhKjŽhM}r[(hO]hP]hQ]hR]hU]uhWNhXhhY]r\(jÄ)r]}r^(hBjæhCjYhIhJhKjĒhM}r_(hO]hP]hQ]hR]hU]uhWKhY]r`hbXSincera…rb}rc(hBUhCj]ubaubjĶ)rd}re(hBU Cabal 2.0rfhM}rg(hO]hP]hQ]hR]hU]uhCjYhY]rhhu)ri}rj(hBjfhM}rk(hO]hP]hQ]hR]hU]uhCjdhY]rlhbX Cabal 2.0rm…rn}ro(hBUhCjiubahKhyubahKjŻubeubjæ)rp}rq(hBUhM}rr(hO]hP]hQ]hR]hU]uhCjUhY]rs(jÄ)rt}ru(hBX Default valuehCjphIhJhKjĒhM}rv(hO]hP]hQ]hR]hU]uhWKhY]rwhbX Default valuerx…ry}rz(hBUhCjtubaubjĶ)r{}r|(hBUhM}r}(hO]hP]hQ]hR]hU]uhCjphY]r~hu)r}r€(hBXHEADhM}r(hO]hP]hQ]hR]hU]uhCj{hY]r‚h›)rƒ}r„(hBX``HEAD``hCjhIhJhKh£hM}r…(hO]hP]hQ]hR]hU]uhWNhXhhY]r†hbXHEADr‡…rˆ}r‰(hBUhINhWNhXhhCjƒubaubahKhyubahKjŻubehKjŽubeubhu)rŠ}r‹(hBX’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ŒhCjQhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMśhXhhY]rŽhbX’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‘(hBjŒhINhWNhXhhCjŠubaubjš)r’}r“(hBXŪ-- UNIX timestamp format example index-state: @1474739268 -- ISO8601 UTC timestamp format example -- This format is used by 'cabal new-configure' -- for storing `--index-state` values. index-state: 2016-09-24T17:47:48ZhCjQhIhJhKjhM}r”(jŸj hR]hQ]hO]hP]hU]uhWMhXhhY]r•hbXŪ-- UNIX timestamp format example index-state: @1474739268 -- ISO8601 UTC timestamp format example -- This format is used by 'cabal new-configure' -- for storing `--index-state` values. index-state: 2016-09-24T17:47:48Zr–…r—}r˜(hBUhCj’ubaubeubeubeubhD)r™}rš(hBUhCjŖhIhJhKhLhM}r›(hO]hP]hQ]hR]rœjī ahU]rh4auhWM hXhhY]rž(h[)rŸ}r (hBXPackage configuration optionsr”hCj™hIhJhKh_hM}r¢(hO]hP]hQ]hR]hU]uhWM hXhhY]r£hbXPackage configuration optionsr¤…r„}r¦(hBj”hINhWNhXhhCjŸubaubhu)r§}rØ(hBXqPackage options affect the building of specific packages. There are three ways a package option can be specified:r©hCj™hIhJhKhyhM}rŖ(hO]hP]hQ]hR]hU]uhWM hXhhY]r«hbXqPackage options affect the building of specific packages. There are three ways a package option can be specified:r¬…r­}r®(hBj©hINhWNhXhhCj§ubaubh‡)rÆ}r°(hBUhCj™hIhJhKhŠhM}r±(hŒX-hR]hQ]hO]hP]hU]uhWMhXhhY]r²(hŽ)r³}r“(hBX_They can be specified at the top-level, in which case they apply only to **local package**, or hCjÆhIhJhKh‘hM}rµ(hO]hP]hQ]hR]hU]uhWNhXhhY]r¶hu)r·}rø(hBX^They can be specified at the top-level, in which case they apply only to **local package**, orhCj³hIhJhKhyhM}r¹(hO]hP]hQ]hR]hU]uhWMhY]rŗ(hbXIThey can be specified at the top-level, in which case they apply only to r»…r¼}r½(hBXIThey can be specified at the top-level, in which case they apply only to hCj·ubjų)r¾}ræ(hBX**local package**hM}rĄ(hO]hP]hQ]hR]hU]uhCj·hY]rĮhbX local packagerĀ…rĆ}rÄ(hBUhCj¾ubahKjubhbX, orrÅ…rĘ}rĒ(hBX, orhCj·ubeubaubhŽ)rČ}rÉ(hBX‘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. hCjÆhIhJhKh‘hM}rŹ(hO]hP]hQ]hR]hU]uhWNhXhhY]rĖhu)rĢ}rĶ(hBX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.hCjČhIhJhKhyhM}rĪ(hO]hP]hQ]hR]hU]uhWMhY]rĻ(hbXThey can be specified inside a rŠ…rŃ}rŅ(hBXThey can be specified inside a hCjĢubh›)rÓ}rŌ(hBX ``package``hM}rÕ(hO]hP]hQ]hR]hU]uhCjĢhY]rÖhbXpackager×…rŲ}rŁ(hBUhCjÓubahKh£ubhbXf stanza, in which case they apply to the build of the package, whether or not it is local or external.rŚ…rŪ}rÜ(hBXf stanza, in which case they apply to the build of the package, whether or not it is local or external.hCjĢubeubaubhŽ)rŻ}rŽ(hBX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. hCjÆhIhJhKh‘hM}rß(hO]hP]hQ]hR]hU]uhWNhXhhY]rąhu)rį}rā(hBX›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.hCjŻhIhJhKhyhM}rć(hO]hP]hQ]hR]hU]uhWMhY]rä(hbX They can be specified inside an r允rę}rē(hBX They can be specified inside an hCjįubh›)rč}ré(hBX ``package *``hM}rź(hO]hP]hQ]hR]hU]uhCjįhY]rėhbX package *rģ…rķ}rī(hBUhCjčubahKh£ubhbXn stanza, in which case they apply to all packages, local ones from the project and also external dependencies.rļ…rš}rń(hBXn stanza, in which case they apply to all packages, local ones from the project and also external dependencies.hCjįubeubaubeubhu)rņ}ró(hBXŪ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``::hCj™hIhJhKhyhM}rō(hO]hP]hQ]hR]hU]uhWMhXhhY]rõ(hbX0For example, the following options specify that rö…r÷}rų(hBX0For example, the following options specify that hINhWNhXhhCjņubj[)rł}rś(hBX:cfg-field:`optimization`rūhCjņhIhJhKj_hM}rü(UreftypeX cfg-fieldjaˆjbX optimizationU refdomainXcabalrżhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMhY]ržh›)r’}r(hBjūhM}r(hO]hP]r(jljżXcabal-cfg-fieldrehQ]hR]hU]uhCjłhY]rhbX optimizationr…r}r(hBUhCj’ubahKh£ubaubhbX7 should be turned off for all local packages, and that r…r }r (hBX7 should be turned off for all local packages, and that hINhWNhXhhCjņubh›)r }r (hBX``bytestring``hM}r (hO]hP]hQ]hR]hU]uhCjņhY]rhbX bytestringr…r}r(hBUhCj ubahKh£ubhbX8 (possibly an external dependency) should be built with r…r}r(hBX8 (possibly an external dependency) should be built with hINhWNhXhhCjņubh›)r}r(hBX``-fno-state-hack``hM}r(hO]hP]hQ]hR]hU]uhCjņhY]rhbX-fno-state-hackr…r}r(hBUhCjubahKh£ubhbX:…r}r(hBX:hINhWNhXhhCjņubeubjš)r}r(hBXHoptimization: False package bytestring ghc-options: -fno-state-hackhCj™hIhJhKjhM}r (jŸj hR]hQ]hO]hP]hU]uhWM hXhhY]r!hbXHoptimization: False package bytestring ghc-options: -fno-state-hackr"…r#}r$(hBUhCjubaubhu)r%}r&(hBX)``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`.)hCj™hIhJhKhyhM}r'(hO]hP]hQ]hR]hU]uhWM%hXhhY]r((h›)r)}r*(hBX``ghc-options``hM}r+(hO]hP]hQ]hR]hU]uhCj%hY]r,hbX ghc-optionsr-…r.}r/(hBUhCj)ubahKh£ubhbX~ is not specifically described in this documentation, but is one of many fields for configuring programs. They take the form r0…r1}r2(hBX~ is not specifically described in this documentation, but is one of many fields for configuring programs. They take the form hINhWNhXhhCj%ubh›)r3}r4(hBX``progname-options``hM}r5(hO]hP]hQ]hR]hU]uhCj%hY]r6hbXprogname-optionsr7…r8}r9(hBUhCj3ubahKh£ubhbX and r:…r;}r<(hBX and hINhWNhXhhCj%ubh›)r=}r>(hBX``progname-location``hM}r?(hO]hP]hQ]hR]hU]uhCj%hY]r@hbXprogname-locationrA…rB}rC(hBUhCj=ubahKh£ubhbX_, and can only be set inside package stanzas. (TODO: They are not supported at top-level, see rD…rE}rF(hBX_, and can only be set inside package stanzas. (TODO: They are not supported at top-level, see hINhWNhXhhCj%ubji)rG}rH(hBX#3579hM}rI(UrefuriX,https://github.com/haskell/cabal/issues/3579hR]hQ]hO]hP]hU]Uinternal‰uhCj%hY]rJhbX#3579rK…rL}rM(hBUhCjGubahKjrubhbX.)rN…rO}rP(hBX.)hINhWNhXhhCj%ubeubhu)rQ}rR(hBXAt 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.)rShCj™hIhJhKhyhM}rT(hO]hP]hQ]hR]hU]uhWM+hXhhY]rUhbXAt 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.)rV…rW}rX(hBjShINhWNhXhhCjQubaubhu)rY}rZ(hBXč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[hCj™hIhJhKhyhM}r\(hO]hP]hQ]hR]hU]uhWM0hXhhY]r]hbXč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`(hBj[hINhWNhXhhCjYubaubjw)ra}rb(hBUhCj™hIhJhKjzhM}rc(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rd}re(hBUhCj™hIhJhKjhM}rf(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrgj…jguhWNhXhhY]rh(j‡)ri}rj(hBX7flags: list of +flagname or -flagname (space separated)hCjdhIhJhKjŠhM}rk(hR]rlXcfg-field-flagsrmahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rn(jw)ro}rp(hBUhCjihIhJhKjzhM}rq(hR]hQ]hO]hP]hU]Uentries]rr(j”Xflags ; cabal project optionjmUNtrsauhWNhXhhY]ubj–)rt}ru(hBXflagsrvhCjihIhJhKjšhM}rw(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rxhbXflagsry…rz}r{(hBUhINhWNhXhhCjtubaubj )r|}r}(hBj£hCjihIhJhKj¤hM}r~(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX: r€…r}r‚(hBUhINhWNhXhhCj|ubaubjŖ)rƒ}r„(hBX0list of +flagname or -flagname (space separated)hCjihIhJhKj­hM}r…(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r†hbX0list of +flagname or -flagname (space separated)r‡…rˆ}r‰(hBUhINhWNhXhhCjƒubaubeubj‡)rŠ}r‹(hBX"--flags="+foo -bar", -ffoo, -f-barhCjdhIhJhKjŠhM}rŒ(hR]rXcfg-flag---flagsrŽahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r(jw)r}r‘(hBUhCjŠhIhJhKjzhM}r’(hR]hQ]hO]hP]hU]Uentries]r“(j”X--flags; cabal project optionjŽUNtr”auhWNhXhhY]ubj–)r•}r–(hBX--flagsr—hCjŠhIhJhKjšhM}r˜(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r™hbX--flagsrš…r›}rœ(hBUhINhWNhXhhCj•ubaubj )r}rž(hBX ="+foo -bar"hCjŠhIhJhKj¤hM}rŸ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX ="+foo -bar"r”…r¢}r£(hBUhINhWNhXhhCjubaubj–)r¤}r„(hBjdhCjŠhIhJhKjšhM}r¦(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§hbX, rØ…r©}rŖ(hBUhINhWNhXhhCj¤ubaubj–)r«}r¬(hBX-ffoohCjŠhIhJhKjšhM}r­(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r®hbX-ffoorÆ…r°}r±(hBUhINhWNhXhhCj«ubaubj )r²}r³(hBU hCjŠhIhJhKj¤hM}r“(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rµhbX …r¶}r·(hBUhINhWNhXhhCj²ubaubj–)rø}r¹(hBjdhCjŠhIhJhKjšhM}rŗ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r»hbX, r¼…r½}r¾(hBUhINhWNhXhhCjøubaubj–)ræ}rĄ(hBX-f-barhCjŠhIhJhKjšhM}rĮ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĀhbX-f-barrĆ…rÄ}rÅ(hBUhINhWNhXhhCjæubaubj )rĘ}rĒ(hBU hCjŠhIhJhKj¤hM}rČ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÉhbX …rŹ}rĖ(hBUhINhWNhXhhCjĘubaubeubj³)rĢ}rĶ(hBUhCjdhIhJhKj¶hM}rĪ(hO]hP]hQ]hR]hU]uhWNhXhhY]rĻ(hu)rŠ}rŃ(hBX®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:hCjĢhIhJhKhyhM}rŅ(hO]hP]hQ]hR]hU]uhWM9hXhhY]rÓ(hbXForce all flags specified as rŌ…rÕ}rÖ(hBXForce all flags specified as hINhWNhXhhCjŠubh›)r×}rŲ(hBX ``+flagname``hM}rŁ(hO]hP]hQ]hR]hU]uhCjŠhY]rŚhbX +flagnamerŪ…rÜ}rŻ(hBUhCj×ubahKh£ubhbX( to be true, and all flags specified as rŽ…rß}rą(hBX( to be true, and all flags specified as hINhWNhXhhCjŠubh›)rį}rā(hBX ``-flagname``hM}rć(hO]hP]hQ]hR]hU]uhCjŠhY]rähbX -flagnamer允rę}rē(hBUhCjįubahKh£ubhbX. to be false. For example, to enable the flag r腁ré}rź(hBX. to be false. For example, to enable the flag hINhWNhXhhCjŠubh›)rė}rģ(hBX``foo``hM}rķ(hO]hP]hQ]hR]hU]uhCjŠhY]rīhbXfoorļ…rš}rń(hBUhCjėubahKh£ubhbX and disable rņ…ró}rō(hBX and disable hINhWNhXhhCjŠubh›)rõ}rö(hBX``bar``hM}r÷(hO]hP]hQ]hR]hU]uhCjŠhY]rųhbXbarrł…rś}rū(hBUhCjõubahKh£ubhbX, set:rü…rż}rž(hBX, set:hINhWNhXhhCjŠubeubjš)r’}r(hBXflags: +foo -barhCjĢhIhJhKjhM}r(jŸj hR]hQ]hO]hP]hU]uhWM?hXhhY]rhbXflags: +foo -barr…r}r(hBUhCj’ubaubhu)r}r(hBXlIf there is no leading punctuation, it is assumed that the flag should be enabled; e.g., this is equivalent:rhCjĢhIhJhKhyhM}r (hO]hP]hQ]hR]hU]uhWMAhXhhY]r hbXlIf there is no leading punctuation, it is assumed that the flag should be enabled; e.g., this is equivalent:r …r }r (hBjhINhWNhXhhCjubaubjš)r}r(hBXflags: foo -barhCjĢhIhJhKjhM}r(jŸj hR]hQ]hO]hP]hU]uhWMFhXhhY]rhbXflags: foo -barr…r}r(hBUhCjubaubhu)r}r(hBXė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.hCjĢhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMHhXhhY]r(hbX Flags are r…r}r(hBX Flags are hINhWNhXhhCjubjŖ)r}r(hBX *per-package*hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbX per-packager …r!}r"(hBUhCjubahKj²ubhbXd, so it doesnā€™t make much sense to specify flags at the top-level, unless you happen to know that r#…r$}r%(hBXb, so it doesn't make much sense to specify flags at the top-level, unless you happen to know that hINhWNhXhhCjubjŖ)r&}r'(hBX*all*hM}r((hO]hP]hQ]hR]hU]uhCjhY]r)hbXallr*…r+}r,(hBUhCj&ubahKj²ubhbXm of your local packages support the same named flags. If a flag is not supported by a package, it is ignored.r-…r.}r/(hBXm of your local packages support the same named flags. If a flag is not supported by a package, it is ignored.hINhWNhXhhCjubeubhu)r0}r1(hBXASee also the solver configuration field :cfg-field:`constraints`.hCjĢhIhJhKhyhM}r2(hO]hP]hQ]hR]hU]uhWMMhXhhY]r3(hbX(See also the solver configuration field r4…r5}r6(hBX(See also the solver configuration field hINhWNhXhhCj0ubj[)r7}r8(hBX:cfg-field:`constraints`r9hCj0hIhJhKj_hM}r:(UreftypeX cfg-fieldjaˆjbX constraintsU refdomainXcabalr;hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMMhY]r<h›)r=}r>(hBj9hM}r?(hO]hP]r@(jlj;Xcabal-cfg-fieldrAehQ]hR]hU]uhCj7hY]rBhbX constraintsrC…rD}rE(hBUhCj=ubahKh£ubaubhbX.…rF}rG(hBX.hINhWNhXhhCj0ubeubhu)rH}rI(hBXfThe command line variant of this flag is ``--flags``. There is also a shortened form ``-ffoo -f-bar``.hCjĢhIhJhKhyhM}rJ(hO]hP]hQ]hR]hU]uhWMOhXhhY]rK(hbX)The command line variant of this flag is rL…rM}rN(hBX)The command line variant of this flag is hINhWNhXhhCjHubh›)rO}rP(hBX ``--flags``hM}rQ(hO]hP]hQ]hR]hU]uhCjHhY]rRhbX--flagsrS…rT}rU(hBUhCjOubahKh£ubhbX!. There is also a shortened form rV…rW}rX(hBX!. There is also a shortened form hINhWNhXhhCjHubh›)rY}rZ(hBX``-ffoo -f-bar``hM}r[(hO]hP]hQ]hR]hU]uhCjHhY]r\hbX -ffoo -f-barr]…r^}r_(hBUhCjYubahKh£ubhbX.…r`}ra(hBX.hINhWNhXhhCjHubeubhu)rb}rc(hBX2A common mistake is to say ``cabal new-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.hCjĢhIhJhKhyhM}rd(hO]hP]hQ]hR]hU]uhWMRhXhhY]re(hbXA common mistake is to say rf…rg}rh(hBXA common mistake is to say hINhWNhXhhCjbubh›)ri}rj(hBX``cabal new-build -fhans``hM}rk(hO]hP]hQ]hR]hU]uhCjbhY]rlhbXcabal new-build -fhansrm…rn}ro(hBUhCjiubahKh£ubhbX, where rp…rq}rr(hBX, where hINhWNhXhhCjbubh›)rs}rt(hBX``hans``hM}ru(hO]hP]hQ]hR]hU]uhCjbhY]rvhbXhansrw…rx}ry(hBUhCjsubahKh£ubhbX} is a flag for a transitive dependency that is not in the local package; in this case, the flag will be silently ignored. If rz…r{}r|(hBX} is a flag for a transitive dependency that is not in the local package; in this case, the flag will be silently ignored. If hINhWNhXhhCjbubh›)r}}r~(hBX``haskell-tor``hM}r(hO]hP]hQ]hR]hU]uhCjbhY]r€hbX haskell-torr…r‚}rƒ(hBUhCj}ubahKh£ubhbX4 is the package you want this flag to apply to, try r„…r…}r†(hBX4 is the package you want this flag to apply to, try hINhWNhXhhCjbubh›)r‡}rˆ(hBX$``--constraint="haskell-tor +hans"``hM}r‰(hO]hP]hQ]hR]hU]uhCjbhY]rŠhbX --constraint="haskell-tor +hans"r‹…rŒ}r(hBUhCj‡ubahKh£ubhbX instead.rŽ…r}r(hBX instead.hINhWNhXhhCjbubeubeubeubjw)r‘}r’(hBUhCj™hIhJhKjzhM}r“(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r”}r•(hBUhCj™hIhJhKjhM}r–(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr—j…j—uhWNhXhhY]r˜(j‡)r™}rš(hBXwith-compiler: executablehCj”hIhJhKjŠhM}r›(hR]rœXcfg-field-with-compilerrahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rž(jw)rŸ}r (hBUhCj™hIhJhKjzhM}r”(hR]hQ]hO]hP]hU]Uentries]r¢(j”X$with-compiler ; cabal project optionjUNtr£auhWNhXhhY]ubj–)r¤}r„(hBX with-compilerr¦hCj™hIhJhKjšhM}r§(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rØhbX with-compilerr©…rŖ}r«(hBUhINhWNhXhhCj¤ubaubj )r¬}r­(hBj£hCj™hIhJhKj¤hM}r®(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÆhbX: r°…r±}r²(hBUhINhWNhXhhCj¬ubaubjŖ)r³}r“(hBX executablehCj™hIhJhKj­hM}rµ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¶hbX executabler·…rø}r¹(hBUhINhWNhXhhCj³ubaubeubj‡)rŗ}r»(hBX--with-compiler=executablehCj”hIhJhKjŠhM}r¼(hR]r½Xcfg-flag---with-compilerr¾ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]ræ(jw)rĄ}rĮ(hBUhCjŗhIhJhKjzhM}rĀ(hR]hQ]hO]hP]hU]Uentries]rĆ(j”X%--with-compiler; cabal project optionj¾UNtrÄauhWNhXhhY]ubj–)rÅ}rĘ(hBX--with-compilerrĒhCjŗhIhJhKjšhM}rČ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÉhbX--with-compilerrŹ…rĖ}rĢ(hBUhINhWNhXhhCjÅubaubj )rĶ}rĪ(hBX =executablehCjŗhIhJhKj¤hM}rĻ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠhbX =executablerŃ…rŅ}rÓ(hBUhINhWNhXhhCjĶubaubeubj³)rŌ}rÕ(hBUhCj”hIhJhKj¶hM}rÖ(hO]hP]hQ]hR]hU]uhWNhXhhY]r×(hu)rŲ}rŁ(hBXSpecify 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.hCjŌhIhJhKhyhM}rŚ(hO]hP]hQ]hR]hU]uhWM\hXhhY]rŪ(hbXtSpecify the path to a particular compiler to be used. If not an absolute path, it will be resolved according to the rÜ…rŻ}rŽ(hBXtSpecify the path to a particular compiler to be used. If not an absolute path, it will be resolved according to the hINhWNhXhhCjŲubjw)rß}rą(hBUhM}rį(hR]hQ]hO]hP]hU]Uentriesrā]rć((UsingleräXPATHråUindex-1ręUNtrē(jäXenvironment variable; PATHjęUNtrčeuhCjŲhY]hKjzubj€)ré}rź(hBUhM}rė(hO]hP]hQ]hR]rģjęahU]uhCjŲhY]hKj†ubj[)rķ}rī(hBX:envvar:`PATH`rļhCjŲhIhJhKj_hM}rš(UreftypeXenvvarja‰jbjåU refdomainXstdrńhR]hQ]U refexplicit‰hO]hP]hU]jdjeuhWM\hY]rņh›)ró}rō(hBjļhM}rõ(hO]hP]rö(jljńX std-envvarr÷ehQ]hR]hU]uhCjķhY]rųhbXPATHrł…rś}rū(hBUhCjóubahKh£ubaubhbXd environment. The type of the compiler (GHC, GHCJS, etc) must be consistent with the setting of the rü…rż}rž(hBXd environment. The type of the compiler (GHC, GHCJS, etc) must be consistent with the setting of the hINhWNhXhhCjŲubj[)r’}r(hBX:cfg-field:`compiler`rhCjŲhIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbXcompilerU refdomainXcabalrhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM\hY]rh›)r}r(hBjhM}r(hO]hP]r(jljXcabal-cfg-fieldr ehQ]hR]hU]uhCj’hY]r hbXcompilerr …r }r (hBUhCjubahKh£ubaubhbX field.r…r}r(hBX field.hINhWNhXhhCjŲubeubhu)r}r(hBXĆ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.hCjŌhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMahXhhY]r(hbXtThe most common use of this option is to specify a different version of your compiler to be used; e.g., if you have r…r}r(hBXtThe most common use of this option is to specify a different version of your compiler to be used; e.g., if you have hINhWNhXhhCjubh›)r}r(hBX ``ghc-7.8``hM}r(hO]hP]hQ]hR]hU]uhCjhY]rhbXghc-7.8r…r}r(hBUhCjubahKh£ubhbX in your path, you can specify r…r }r!(hBX in your path, you can specify hINhWNhXhhCjubh›)r"}r#(hBX``with-compiler: ghc-7.8``hM}r$(hO]hP]hQ]hR]hU]uhCjhY]r%hbXwith-compiler: ghc-7.8r&…r'}r((hBUhCj"ubahKh£ubhbX to use it.r)…r*}r+(hBX to use it.hINhWNhXhhCjubeubhu)r,}r-(hBXUThis 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.hCjŌhIhJhKhyhM}r.(hO]hP]hQ]hR]hU]uhWMehXhhY]r/(hbX)This flag also sets the default value of r0…r1}r2(hBX)This flag also sets the default value of hINhWNhXhhCj,ubj[)r3}r4(hBX:cfg-field:`with-hc-pkg`r5hCj,hIhJhKj_hM}r6(UreftypeX cfg-fieldjaˆjbX with-hc-pkgU refdomainXcabalr7hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMehY]r8h›)r9}r:(hBj5hM}r;(hO]hP]r<(jlj7Xcabal-cfg-fieldr=ehQ]hR]hU]uhCj3hY]r>hbX with-hc-pkgr?…r@}rA(hBUhCj9ubahKh£ubaubhbX', using the heuristic that it is named rB…rC}rD(hBX', using the heuristic that it is named hINhWNhXhhCj,ubh›)rE}rF(hBX``ghc-pkg-7.8``hM}rG(hO]hP]hQ]hR]hU]uhCj,hY]rHhbX ghc-pkg-7.8rI…rJ}rK(hBUhCjEubahKh£ubhbXY (if your executable name is suffixed with a version number), or is the executable named rL…rM}rN(hBXY (if your executable name is suffixed with a version number), or is the executable named hINhWNhXhhCj,ubh›)rO}rP(hBX ``ghc-pkg``hM}rQ(hO]hP]hQ]hR]hU]uhCj,hY]rRhbXghc-pkgrS…rT}rU(hBUhCjOubahKh£ubhbX in the same directory as the rV…rW}rX(hBX in the same directory as the hINhWNhXhhCj,ubh›)rY}rZ(hBX``ghc``hM}r[(hO]hP]hQ]hR]hU]uhCj,hY]r\hbXghcr]…r^}r_(hBUhCjYubahKh£ubhbX1 directory. If this heuristic does not work, set r`…ra}rb(hBX1 directory. If this heuristic does not work, set hINhWNhXhhCj,ubj[)rc}rd(hBX:cfg-field:`with-hc-pkg`rehCj,hIhJhKj_hM}rf(UreftypeX cfg-fieldjaˆjbX with-hc-pkgU refdomainXcabalrghR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMehY]rhh›)ri}rj(hBjehM}rk(hO]hP]rl(jljgXcabal-cfg-fieldrmehQ]hR]hU]uhCjchY]rnhbX with-hc-pkgro…rp}rq(hBUhCjiubahKh£ubaubhbX explicitly.rr…rs}rt(hBX explicitly.hINhWNhXhhCj,ubeubhu)ru}rv(hBXĶFor inplace packages, ``cabal new-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.hCjŌhIhJhKhyhM}rw(hO]hP]hQ]hR]hU]uhWMkhXhhY]rx(hbXFor inplace packages, ry…rz}r{(hBXFor inplace packages, hINhWNhXhhCjuubh›)r|}r}(hBX``cabal new-build``hM}r~(hO]hP]hQ]hR]hU]uhCjuhY]rhbXcabal new-buildr€…r}r‚(hBUhCj|ubahKh£ubhbX¤ 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…(hBX¤ 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.hINhWNhXhhCjuubeubhu)r†}r‡(hBXæ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.hCjŌhIhJhKhyhM}rˆ(hO]hP]hQ]hR]hU]uhWMphXhhY]r‰(hbX*At the moment, itā€™s not possible to set rŠ…r‹}rŒ(hBX(At the moment, it's not possible to set hINhWNhXhhCj†ubj[)r}rŽ(hBX:cfg-field:`with-compiler`rhCj†hIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbX with-compilerU refdomainXcabalr‘hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMphY]r’h›)r“}r”(hBjhM}r•(hO]hP]r–(jlj‘Xcabal-cfg-fieldr—ehQ]hR]hU]uhCjhY]r˜hbX with-compilerr™…rš}r›(hBUhCj“ubahKh£ubaubhbX} 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ž(hBX} on a per-package basis, but eventually we plan on relaxing this restriction. If this is something you need, give us a shout.hINhWNhXhhCj†ubeubhu)rŸ}r (hBXsThe command line variant of this flag is ``--with-compiler=ghc-7.8``; there is also a short version ``-w ghc-7.8``.hCjŌhIhJhKhyhM}r”(hO]hP]hQ]hR]hU]uhWMthXhhY]r¢(hbX)The command line variant of this flag is r£…r¤}r„(hBX)The command line variant of this flag is hINhWNhXhhCjŸubh›)r¦}r§(hBX``--with-compiler=ghc-7.8``hM}rØ(hO]hP]hQ]hR]hU]uhCjŸhY]r©hbX--with-compiler=ghc-7.8rŖ…r«}r¬(hBUhCj¦ubahKh£ubhbX ; there is also a short version r­…r®}rÆ(hBX ; there is also a short version hINhWNhXhhCjŸubh›)r°}r±(hBX``-w ghc-7.8``hM}r²(hO]hP]hQ]hR]hU]uhCjŸhY]r³hbX -w ghc-7.8r“…rµ}r¶(hBUhCj°ubahKh£ubhbX.…r·}rø(hBX.hINhWNhXhhCjŸubeubeubeubjw)r¹}rŗ(hBUhCj™hIhJhKjzhM}r»(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r¼}r½(hBUhCj™hIhJhKjhM}r¾(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldræj…jæuhWNhXhhY]rĄ(j‡)rĮ}rĀ(hBXwith-hc-pkg: executablehCj¼hIhJhKjŠhM}rĆ(hR]rÄXcfg-field-with-hc-pkgrÅahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĘ(jw)rĒ}rČ(hBUhCjĮhIhJhKjzhM}rÉ(hR]hQ]hO]hP]hU]Uentries]rŹ(j”X"with-hc-pkg ; cabal project optionjÅUNtrĖauhWNhXhhY]ubj–)rĢ}rĶ(hBX with-hc-pkgrĪhCjĮhIhJhKjšhM}rĻ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠhbX with-hc-pkgrŃ…rŅ}rÓ(hBUhINhWNhXhhCjĢubaubj )rŌ}rÕ(hBj£hCjĮhIhJhKj¤hM}rÖ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r×hbX: rŲ…rŁ}rŚ(hBUhINhWNhXhhCjŌubaubjŖ)rŪ}rÜ(hBX executablehCjĮhIhJhKj­hM}rŻ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŽhbX executablerß…rą}rį(hBUhINhWNhXhhCjŪubaubeubj‡)rā}rć(hBX--with-hc-pkg=executablehCj¼hIhJhKjŠhM}rä(hR]råXcfg-flag---with-hc-pkgręahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rē(jw)rč}ré(hBUhCjāhIhJhKjzhM}rź(hR]hQ]hO]hP]hU]Uentries]rė(j”X#--with-hc-pkg; cabal project optionjęUNtrģauhWNhXhhY]ubj–)rķ}rī(hBX --with-hc-pkgrļhCjāhIhJhKjšhM}rš(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rńhbX --with-hc-pkgrņ…ró}rō(hBUhINhWNhXhhCjķubaubj )rõ}rö(hBX =executablehCjāhIhJhKj¤hM}r÷(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rųhbX =executablerł…rś}rū(hBUhINhWNhXhhCjõubaubeubj³)rü}rż(hBUhCj¼hIhJhKj¶hM}rž(hO]hP]hQ]hR]hU]uhWNhXhhY]r’(hu)r}r(hBXQSpecify 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`.hCjühIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM|hXhhY]r(hbX,Specify the path to the package tool, e.g., r…r}r(hBX,Specify the path to the package tool, e.g., hINhWNhXhhCjubh›)r}r(hBX ``ghc-pkg``hM}r (hO]hP]hQ]hR]hU]uhCjhY]r hbXghc-pkgr …r }r (hBUhCjubahKh£ubhbXF. This package tool must be compatible with the compiler specified by r…r}r(hBXF. This package tool must be compatible with the compiler specified by hINhWNhXhhCjubj[)r}r(hBX:cfg-field:`with-compiler`rhCjhIhJhKj_hM}r(UreftypeX cfg-fieldjaˆjbX with-compilerU refdomainXcabalrhR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM|hY]rh›)r}r(hBjhM}r(hO]hP]r(jljXcabal-cfg-fieldrehQ]hR]hU]uhCjhY]rhbX with-compilerr…r}r(hBUhCjubahKh£ubaubhbXŸ (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"(hBXŸ (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 hINhWNhXhhCjubj[)r#}r$(hBX:cfg-field:`with-compiler`r%hCjhIhJhKj_hM}r&(UreftypeX cfg-fieldjaˆjbX with-compilerU refdomainXcabalr'hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM|hY]r(h›)r)}r*(hBj%hM}r+(hO]hP]r,(jlj'Xcabal-cfg-fieldr-ehQ]hR]hU]uhCj#hY]r.hbX with-compilerr/…r0}r1(hBUhCj)ubahKh£ubaubhbX.…r2}r3(hBX.hINhWNhXhhCjubeubhu)r4}r5(hBXGThe command line variant of this flag is ``--with-hc-pkg=ghc-pkg-7.8``.hCjühIhJhKhyhM}r6(hO]hP]hQ]hR]hU]uhWM‚hXhhY]r7(hbX)The command line variant of this flag is r8…r9}r:(hBX)The command line variant of this flag is hINhWNhXhhCj4ubh›)r;}r<(hBX``--with-hc-pkg=ghc-pkg-7.8``hM}r=(hO]hP]hQ]hR]hU]uhCj4hY]r>hbX--with-hc-pkg=ghc-pkg-7.8r?…r@}rA(hBUhCj;ubahKh£ubhbX.…rB}rC(hBX.hINhWNhXhhCj4ubeubeubeubjw)rD}rE(hBUhCj™hIhJhKjzhM}rF(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rG}rH(hBUhCj™hIhJhKjhM}rI(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrJj…jJuhWNhXhhY]rK(j‡)rL}rM(hBXoptimization: nathCjGhIhJhKjŠhM}rN(hR]rOXcfg-field-optimizationrPahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rQ(jw)rR}rS(hBUhCjLhIhJhKjzhM}rT(hR]hQ]hO]hP]hU]Uentries]rU(j”X#optimization ; cabal project optionjPUNtrVauhWNhXhhY]ubj–)rW}rX(hBX optimizationrYhCjLhIhJhKjšhM}rZ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r[hbX optimizationr\…r]}r^(hBUhINhWNhXhhCjWubaubj )r_}r`(hBj£hCjLhIhJhKj¤hM}ra(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rbhbX: rc…rd}re(hBUhINhWNhXhhCj_ubaubjŖ)rf}rg(hBXnathCjLhIhJhKj­hM}rh(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rihbXnatrj…rk}rl(hBUhINhWNhXhhCjfubaubeubj‡)rm}rn(hBX--enable-optimizationrohCjGhIhJhKjŠhM}rp(hR]rqXcfg-flag---enable-optimizationrrahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rs(jw)rt}ru(hBUhCjmhIhJhKjzhM}rv(hR]hQ]hO]hP]hU]Uentries]rw(j”X+--enable-optimization; cabal project optionjrUNtrxauhWNhXhhY]ubj–)ry}rz(hBjohCjmhIhJhKjšhM}r{(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r|hbX--enable-optimizationr}…r~}r(hBUhINhWNhXhhCjyubaubj )r€}r(hBU hCjmhIhJhKj¤hM}r‚(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rƒhbX …r„}r…(hBUhINhWNhXhhCj€ubaubeubj‡)r†}r‡(hBX--disable-optimizationrˆhCjGhIhJhKjŠhM}r‰(hR]rŠXcfg-flag---disable-optimizationr‹ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŒ(jw)r}rŽ(hBUhCj†hIhJhKjzhM}r(hR]hQ]hO]hP]hU]Uentries]r(j”X,--disable-optimization; cabal project optionj‹UNtr‘auhWNhXhhY]ubj–)r’}r“(hBjˆhCj†hIhJhKjšhM}r”(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r•hbX--disable-optimizationr–…r—}r˜(hBUhINhWNhXhhCj’ubaubj )r™}rš(hBU hCj†hIhJhKj¤hM}r›(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rœhbX …r}rž(hBUhINhWNhXhhCj™ubaubeubj³)rŸ}r (hBUhCjGhIhJhKj¶hM}r”(hO]hP]hQ]hR]hU]uhWNhXhhY]r¢(j¹)r£}r¤(hBUhCjŸhIhJhKj¼hM}r„(hO]hP]hQ]hR]hU]uhWNhXhhY]r¦jæ)r§}rØ(hBUhM}r©(hO]hP]hQ]hR]hU]uhCj£hY]rŖ(jÄ)r«}r¬(hBX Default valuehCj§hIhJhKjĒhM}r­(hO]hP]hQ]hR]hU]uhWKhY]r®hbX Default valuerÆ…r°}r±(hBUhCj«ubaubjĶ)r²}r³(hBUhM}r“(hO]hP]hQ]hR]hU]uhCj§hY]rµhu)r¶}r·(hBX1hM}rø(hO]hP]hQ]hR]hU]uhCj²hY]r¹h›)rŗ}r»(hBX``1``hCj¶hIhJhKh£hM}r¼(hO]hP]hQ]hR]hU]uhWNhXhhY]r½hbX1…r¾}ræ(hBUhINhWNhXhhCjŗubaubahKhyubahKjŻubehKjŽubaubhu)rĄ}rĮ(hBXyBuild with optimization. This is appropriate for production use, taking more time to build faster libraries and programs.rĀhCjŸhIhJhKhyhM}rĆ(hO]hP]hQ]hR]hU]uhWMŒhXhhY]rÄhbXyBuild with optimization. This is appropriate for production use, taking more time to build faster libraries and programs.rÅ…rĘ}rĒ(hBjĀhINhWNhXhhCjĄubaubhu)rČ}rÉ(hBXĪ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.hCjŸhIhJhKhyhM}rŹ(hO]hP]hQ]hR]hU]uhWMhXhhY]rĖ(hbX The optional rĢ…rĶ}rĪ(hBX The optional hINhWNhXhhCjČubjŖ)rĻ}rŠ(hBX*nat*hM}rŃ(hO]hP]hQ]hR]hU]uhCjČhY]rŅhbXnatrÓ…rŌ}rÕ(hBUhCjĻubahKj²ubhbX¼ 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.rÖ…r×}rŲ(hBX¼ 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.hINhWNhXhhCjČubeubhu)rŁ}rŚ(hBXGWhen optimizations are enabled, Cabal passes ``-O2`` to the C compiler.hCjŸhIhJhKhyhM}rŪ(hO]hP]hQ]hR]hU]uhWM—hXhhY]rÜ(hbX-When optimizations are enabled, Cabal passes rŻ…rŽ}rß(hBX-When optimizations are enabled, Cabal passes hINhWNhXhhCjŁubh›)rą}rį(hBX``-O2``hM}rā(hO]hP]hQ]hR]hU]uhCjŁhY]rćhbX-O2r䅁rå}rę(hBUhCjąubahKh£ubhbX to the C compiler.rē…rč}ré(hBX to the C compiler.hINhWNhXhhCjŁubeubhu)rź}rė(hBXJWe also accept ``True`` (equivalent to 1) and ``False`` (equivalent to 0).hCjŸhIhJhKhyhM}rģ(hO]hP]hQ]hR]hU]uhWM™hXhhY]rķ(hbXWe also accept rī…rļ}rš(hBXWe also accept hINhWNhXhhCjźubh›)rń}rņ(hBX``True``hM}ró(hO]hP]hQ]hR]hU]uhCjźhY]rōhbXTruerõ…rö}r÷(hBUhCjńubahKh£ubhbX (equivalent to 1) and rų…rł}rś(hBX (equivalent to 1) and hINhWNhXhhCjźubh›)rū}rü(hBX ``False``hM}rż(hO]hP]hQ]hR]hU]uhCjźhY]ržhbXFalser’…r}r(hBUhCjūubahKh£ubhbX (equivalent to 0).r…r}r(hBX (equivalent to 0).hINhWNhXhhCjźubeubhu)r}r(hBX 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.hCjŸhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWMœhXhhY]r(hbXUNote that as of GHC 8.0, GHC does not recompile when optimization levels change (see r …r }r (hBXUNote that as of GHC 8.0, GHC does not recompile when optimization levels change (see hINhWNhXhhCjubji)r }r (hBX GHC #10923hM}r(UrefuriX,http://ghc.haskell.org/trac/ghc/ticket/10923hR]hQ]hO]hP]hU]Uinternal‰uhCjhY]rhbX GHC #10923r…r}r(hBUhCj ubahKjrubhbX„), 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.r…r}r(hBX„), 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.hINhWNhXhhCjubeubhu)r}r(hBX±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``.hCjŸhIhJhKhyhM}r(hO]hP]hQ]hR]hU]uhWM¢hXhhY]r(hbX)The command line variant of this flag is r…r}r(hBX)The command line variant of this flag is hINhWNhXhhCjubh›)r}r(hBX``-O2``hM}r(hO]hP]hQ]hR]hU]uhCjhY]r hbX-O2r!…r"}r#(hBUhCjubahKh£ubhbX (with r$…r%}r&(hBX (with hINhWNhXhhCjubh›)r'}r((hBX``-O1``hM}r)(hO]hP]hQ]hR]hU]uhCjhY]r*hbX-O1r+…r,}r-(hBUhCj'ubahKh£ubhbX equivalent to r.…r/}r0(hBX equivalent to hINhWNhXhhCjubh›)r1}r2(hBX``-O``hM}r3(hO]hP]hQ]hR]hU]uhCjhY]r4hbX-Or5…r6}r7(hBUhCj1ubahKh£ubhbX%). There are also long-form variants r8…r9}r:(hBX%). There are also long-form variants hINhWNhXhhCjubh›)r;}r<(hBX``--enable-optimization``hM}r=(hO]hP]hQ]hR]hU]uhCjhY]r>hbX--enable-optimizationr?…r@}rA(hBUhCj;ubahKh£ubhbX and rB…rC}rD(hBX and hINhWNhXhhCjubh›)rE}rF(hBX``--disable-optimization``hM}rG(hO]hP]hQ]hR]hU]uhCjhY]rHhbX--disable-optimizationrI…rJ}rK(hBUhCjEubahKh£ubhbX.…rL}rM(hBX.hINhWNhXhhCjubeubeubeubjw)rN}rO(hBUhCj™hIhJhKjzhM}rP(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rQ}rR(hBUhCj™hIhJhKjhM}rS(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrTj…jTuhWNhXhhY]rU(j‡)rV}rW(hBX)configure-options: args (space separated)hCjQhIhJhKjŠhM}rX(hR]rYXcfg-field-configure-optionsrZahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r[(jw)r\}r](hBUhCjVhIhJhKjzhM}r^(hR]hQ]hO]hP]hU]Uentries]r_(j”X(configure-options ; cabal project optionjZUNtr`auhWNhXhhY]ubj–)ra}rb(hBXconfigure-optionsrchCjVhIhJhKjšhM}rd(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rehbXconfigure-optionsrf…rg}rh(hBUhINhWNhXhhCjaubaubj )ri}rj(hBj£hCjVhIhJhKj¤hM}rk(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rlhbX: rm…rn}ro(hBUhINhWNhXhhCjiubaubjŖ)rp}rq(hBXargs (space separated)hCjVhIhJhKj­hM}rr(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rshbXargs (space separated)rt…ru}rv(hBUhINhWNhXhhCjpubaubeubj‡)rw}rx(hBX--configure-option=arghCjQhIhJhKjŠhM}ry(hR]rzXcfg-flag---configure-optionr{ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r|(jw)r}}r~(hBUhCjwhIhJhKjzhM}r(hR]hQ]hO]hP]hU]Uentries]r€(j”X(--configure-option; cabal project optionj{UNtrauhWNhXhhY]ubj–)r‚}rƒ(hBX--configure-optionr„hCjwhIhJhKjšhM}r…(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r†hbX--configure-optionr‡…rˆ}r‰(hBUhINhWNhXhhCj‚ubaubj )rŠ}r‹(hBX=arghCjwhIhJhKj¤hM}rŒ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX=argrŽ…r}r(hBUhINhWNhXhhCjŠubaubeubj³)r‘}r’(hBUhCjQhIhJhKj¶hM}r“(hO]hP]hQ]hR]hU]uhWNhXhhY]r”(hu)r•}r–(hBXA 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 `__.hCj‘hIhJhKhyhM}r—(hO]hP]hQ]hR]hU]uhWMŖhXhhY]r˜(hbX2A list of extra arguments to pass to the external r™…rš}r›(hBX2A list of extra arguments to pass to the external hINhWNhXhhCj•ubh›)rœ}r(hBX``./configure``hM}rž(hO]hP]hQ]hR]hU]uhCj•hY]rŸhbX ./configurer …r”}r¢(hBUhCjœubahKh£ubhbXI script, if one is used. This is only useful for packages which have the r£…r¤}r„(hBXI script, if one is used. This is only useful for packages which have the hINhWNhXhhCj•ubh›)r¦}r§(hBX ``Configure``hM}rØ(hO]hP]hQ]hR]hU]uhCj•hY]r©hbX ConfigurerŖ…r«}r¬(hBUhCj¦ubahKh£ubhbX% build type. See also the section on r­…r®}rÆ(hBX% build type. See also the section on hINhWNhXhhCj•ubji)r°}r±(hBXV`system-dependent parameters `__hM}r²(UnameXsystem-dependent parametersjmX4developing-packages.html#system-dependent-parametershR]hQ]hO]hP]hU]uhCj•hY]r³hbXsystem-dependent parametersr“…rµ}r¶(hBUhCj°ubahKjrubhbX.…r·}rø(hBX.hINhWNhXhhCj•ubeubhu)r¹}rŗ(hBX„The command line variant of this flag is ``--configure-option=arg``, which can be specified multiple times to pass multiple options.hCj‘hIhJhKhyhM}r»(hO]hP]hQ]hR]hU]uhWM°hXhhY]r¼(hbX)The command line variant of this flag is r½…r¾}ræ(hBX)The command line variant of this flag is hINhWNhXhhCj¹ubh›)rĄ}rĮ(hBX``--configure-option=arg``hM}rĀ(hO]hP]hQ]hR]hU]uhCj¹hY]rĆhbX--configure-option=argrÄ…rÅ}rĘ(hBUhCjĄubahKh£ubhbXA, which can be specified multiple times to pass multiple options.rĒ…rČ}rÉ(hBXA, which can be specified multiple times to pass multiple options.hINhWNhXhhCj¹ubeubeubeubjw)rŹ}rĖ(hBUhCj™hIhJhKjzhM}rĢ(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rĶ}rĪ(hBUhCj™hIhJhKjhM}rĻ(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrŠj…jŠuhWNhXhhY]rŃ(j‡)rŅ}rÓ(hBX4compiler: ghc, ghcjs, jhc, lhc, uhc or haskell-suitehCjĶhIhJhKjŠhM}rŌ(hR]rÕXcfg-field-compilerrÖahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r×(jw)rŲ}rŁ(hBUhCjŅhIhJhKjzhM}rŚ(hR]hQ]hO]hP]hU]Uentries]rŪ(j”Xcompiler ; cabal project optionjÖUNtrÜauhWNhXhhY]ubj–)rŻ}rŽ(hBXcompilerrßhCjŅhIhJhKjšhM}rą(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rįhbXcompilerrā…rć}rä(hBUhINhWNhXhhCjŻubaubj )rå}rę(hBj£hCjŅhIhJhKj¤hM}rē(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rčhbX: r酁rź}rė(hBUhINhWNhXhhCjåubaubjŖ)rģ}rķ(hBX*ghc, ghcjs, jhc, lhc, uhc or haskell-suitehCjŅhIhJhKj­hM}rī(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rļhbX*ghc, ghcjs, jhc, lhc, uhc or haskell-suiterš…rń}rņ(hBUhINhWNhXhhCjģubaubeubj‡)ró}rō(hBX--compiler=compilerhCjĶhIhJhKjŠhM}rõ(hR]röXcfg-flag---compilerr÷ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rų(jw)rł}rś(hBUhCjóhIhJhKjzhM}rū(hR]hQ]hO]hP]hU]Uentries]rü(j”X --compiler; cabal project optionj÷UNtrżauhWNhXhhY]ubj–)rž}r’(hBX --compilerrhCjóhIhJhKjšhM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX --compilerr…r}r(hBUhINhWNhXhhCjžubaubj )r}r(hBX =compilerhCjóhIhJhKj¤hM}r(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX =compilerr …r }r (hBUhINhWNhXhhCjubaubeubj³)r }r(hBUhCjĶhIhJhKj¶hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]r(j¹)r}r(hBUhCj hIhJhKj¼hM}r(hO]hP]hQ]hR]hU]uhWNhXhhY]rjæ)r}r(hBUhM}r(hO]hP]hQ]hR]hU]uhCjhY]r(jÄ)r}r(hBX Default valuehCjhIhJhKjĒhM}r(hO]hP]hQ]hR]hU]uhWKhY]rhbX Default valuer…r}r(hBUhCjubaubjĶ)r }r!(hBUhM}r"(hO]hP]hQ]hR]hU]uhCjhY]r#hu)r$}r%(hBXghchM}r&(hO]hP]hQ]hR]hU]uhCj hY]r'h›)r(}r)(hBX``ghc``hCj$hIhJhKh£hM}r*(hO]hP]hQ]hR]hU]uhWNhXhhY]r+hbXghcr,…r-}r.(hBUhINhWNhXhhCj(ubaubahKhyubahKjŻubehKjŽubaubhu)r/}r0(hBX“Specify which compiler toolchain to be used. This is independent of ``with-compiler``, because the choice of toolchain affects Cabal's build logic.hCj hIhJhKhyhM}r1(hO]hP]hQ]hR]hU]uhWM¹hXhhY]r2(hbXDSpecify which compiler toolchain to be used. This is independent of r3…r4}r5(hBXDSpecify which compiler toolchain to be used. This is independent of hINhWNhXhhCj/ubh›)r6}r7(hBX``with-compiler``hM}r8(hO]hP]hQ]hR]hU]uhCj/hY]r9hbX with-compilerr:…r;}r<(hBUhCj6ubahKh£ubhbX@, because the choice of toolchain affects Cabalā€™s build logic.r=…r>}r?(hBX>, because the choice of toolchain affects Cabal's build logic.hINhWNhXhhCj/ubeubhu)r@}rA(hBX<The command line variant of this flag is ``--compiler=ghc``.hCj hIhJhKhyhM}rB(hO]hP]hQ]hR]hU]uhWM½hXhhY]rC(hbX)The command line variant of this flag is rD…rE}rF(hBX)The command line variant of this flag is hINhWNhXhhCj@ubh›)rG}rH(hBX``--compiler=ghc``hM}rI(hO]hP]hQ]hR]hU]uhCj@hY]rJhbX--compiler=ghcrK…rL}rM(hBUhCjGubahKh£ubhbX.…rN}rO(hBX.hINhWNhXhhCj@ubeubeubeubjw)rP}rQ(hBUhCj™hIhJhKjzhM}rR(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rS}rT(hBUhCj™hIhJhKjhM}rU(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrVj…jVuhWNhXhhY]rW(j‡)rX}rY(hBXtests: booleanhCjShIhJhKjŠhM}rZ(hR]r[Xcfg-field-testsr\ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r](jw)r^}r_(hBUhCjXhIhJhKjzhM}r`(hR]hQ]hO]hP]hU]Uentries]ra(j”Xtests ; cabal project optionj\UNtrbauhWNhXhhY]ubj–)rc}rd(hBXtestsrehCjXhIhJhKjšhM}rf(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rghbXtestsrh…ri}rj(hBUhINhWNhXhhCjcubaubj )rk}rl(hBj£hCjXhIhJhKj¤hM}rm(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rnhbX: ro…rp}rq(hBUhINhWNhXhhCjkubaubjŖ)rr}rs(hBXbooleanhCjXhIhJhKj­hM}rt(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ruhbXbooleanrv…rw}rx(hBUhINhWNhXhhCjrubaubeubj‡)ry}rz(hBX--enable-testsr{hCjShIhJhKjŠhM}r|(hR]r}Xcfg-flag---enable-testsr~ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r(jw)r€}r(hBUhCjyhIhJhKjzhM}r‚(hR]hQ]hO]hP]hU]Uentries]rƒ(j”X$--enable-tests; cabal project optionj~UNtr„auhWNhXhhY]ubj–)r…}r†(hBj{hCjyhIhJhKjšhM}r‡(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rˆhbX--enable-testsr‰…rŠ}r‹(hBUhINhWNhXhhCj…ubaubj )rŒ}r(hBU hCjyhIhJhKj¤hM}rŽ(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rhbX …r}r‘(hBUhINhWNhXhhCjŒubaubeubj‡)r’}r“(hBX--disable-testsr”hCjShIhJhKjŠhM}r•(hR]r–Xcfg-flag---disable-testsr—ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r˜(jw)r™}rš(hBUhCj’hIhJhKjzhM}r›(hR]hQ]hO]hP]hU]Uentries]rœ(j”X%--disable-tests; cabal project optionj—UNtrauhWNhXhhY]ubj–)rž}rŸ(hBj”hCj’hIhJhKjšhM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r”hbX--disable-testsr¢…r£}r¤(hBUhINhWNhXhhCjžubaubj )r„}r¦(hBU hCj’hIhJhKj¤hM}r§(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rØhbX …r©}rŖ(hBUhINhWNhXhhCj„ubaubeubj³)r«}r¬(hBUhCjShIhJhKj¶hM}r­(hO]hP]hQ]hR]hU]uhWNhXhhY]r®(j¹)rÆ}r°(hBUhCj«hIhJhKj¼hM}r±(hO]hP]hQ]hR]hU]uhWNhXhhY]r²jæ)r³}r“(hBUhM}rµ(hO]hP]hQ]hR]hU]uhCjÆhY]r¶(jÄ)r·}rø(hBX Default valuehCj³hIhJhKjĒhM}r¹(hO]hP]hQ]hR]hU]uhWKhY]rŗhbX Default valuer»…r¼}r½(hBUhCj·ubaubjĶ)r¾}ræ(hBUhM}rĄ(hO]hP]hQ]hR]hU]uhCj³hY]rĮhu)rĀ}rĆ(hBXFalsehM}rÄ(hO]hP]hQ]hR]hU]uhCj¾hY]rÅh›)rĘ}rĒ(hBX ``False``hCjĀhIhJhKh£hM}rČ(hO]hP]hQ]hR]hU]uhWNhXhhY]rÉhbXFalserŹ…rĖ}rĢ(hBUhINhWNhXhhCjĘubaubahKhyubahKjŻubehKjŽubaubhu)rĶ}rĪ(hBXForce 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.hCj«hIhJhKhyhM}rĻ(hO]hP]hQ]hR]hU]uhWMĘhXhhY]rŠ(hbXž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Ņ}rÓ(hBXž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 hINhWNhXhhCjĶubh›)rŌ}rÕ(hBX ``False``hM}rÖ(hO]hP]hQ]hR]hU]uhCjĶhY]r×hbXFalserŲ…rŁ}rŚ(hBUhCjŌubahKh£ubhbX]; furthermore, test suites are automatically enabled if they are requested as a built target.rŪ…rÜ}rŻ(hBX]; furthermore, test suites are automatically enabled if they are requested as a built target.hINhWNhXhhCjĶubeubhu)rŽ}rß(hBXTThe command line variant of this flag is ``--enable-tests`` and ``--disable-tests``.hCj«hIhJhKhyhM}rą(hO]hP]hQ]hR]hU]uhWMĖhXhhY]rį(hbX)The command line variant of this flag is rā…rć}rä(hBX)The command line variant of this flag is hINhWNhXhhCjŽubh›)rå}rę(hBX``--enable-tests``hM}rē(hO]hP]hQ]hR]hU]uhCjŽhY]rčhbX--enable-testsr酁rź}rė(hBUhCjåubahKh£ubhbX and rģ…rķ}rī(hBX and hINhWNhXhhCjŽubh›)rļ}rš(hBX``--disable-tests``hM}rń(hO]hP]hQ]hR]hU]uhCjŽhY]rņhbX--disable-testsró…rō}rõ(hBUhCjļubahKh£ubhbX.…rö}r÷(hBX.hINhWNhXhhCjŽubeubeubeubjw)rų}rł(hBUhCj™hIhJhKjzhM}rś(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rū}rü(hBUhCj™hIhJhKjhM}rż(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldržj…jžuhWNhXhhY]r’(j‡)r }r (hBXbenchmarks: booleanhCjūhIhJhKjŠhM}r (hR]r Xcfg-field-benchmarksr ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r (jw)r }r (hBUhCj hIhJhKjzhM}r (hR]hQ]hO]hP]hU]Uentries]r (j”X!benchmarks ; cabal project optionj UNtr auhWNhXhhY]ubj–)r }r (hBX benchmarksr hCj hIhJhKjšhM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX benchmarksr …r }r (hBUhINhWNhXhhCj ubaubj )r }r (hBj£hCj hIhJhKj¤hM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbX: r …r }r (hBUhINhWNhXhhCj ubaubjŖ)r }r (hBXbooleanhCj hIhJhKj­hM}r (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r hbXbooleanr …r }r (hBUhINhWNhXhhCj ubaubeubj‡)r! }r" (hBX--enable-benchmarksr# hCjūhIhJhKjŠhM}r$ (hR]r% Xcfg-flag---enable-benchmarksr& ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r' (jw)r( }r) (hBUhCj! hIhJhKjzhM}r* (hR]hQ]hO]hP]hU]Uentries]r+ (j”X)--enable-benchmarks; cabal project optionj& UNtr, auhWNhXhhY]ubj–)r- }r. (hBj# hCj! hIhJhKjšhM}r/ (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r0 hbX--enable-benchmarksr1 …r2 }r3 (hBUhINhWNhXhhCj- ubaubj )r4 }r5 (hBU hCj! hIhJhKj¤hM}r6 (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r7 hbX …r8 }r9 (hBUhINhWNhXhhCj4 ubaubeubj‡)r: }r; (hBX--disable-benchmarksr< hCjūhIhJhKjŠhM}r= (hR]r> Xcfg-flag---disable-benchmarksr? ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r@ (jw)rA }rB (hBUhCj: hIhJhKjzhM}rC (hR]hQ]hO]hP]hU]Uentries]rD (j”X*--disable-benchmarks; cabal project optionj? UNtrE auhWNhXhhY]ubj–)rF }rG (hBj< hCj: hIhJhKjšhM}rH (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rI hbX--disable-benchmarksrJ …rK }rL (hBUhINhWNhXhhCjF ubaubj )rM }rN (hBU hCj: hIhJhKj¤hM}rO (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rP hbX …rQ }rR (hBUhINhWNhXhhCjM ubaubeubj³)rS }rT (hBUhCjūhIhJhKj¶hM}rU (hO]hP]hQ]hR]hU]uhWNhXhhY]rV (j¹)rW }rX (hBUhCjS hIhJhKj¼hM}rY (hO]hP]hQ]hR]hU]uhWNhXhhY]rZ jæ)r[ }r\ (hBUhM}r] (hO]hP]hQ]hR]hU]uhCjW hY]r^ (jÄ)r_ }r` (hBX Default valuehCj[ hIhJhKjĒhM}ra (hO]hP]hQ]hR]hU]uhWKhY]rb hbX Default valuerc …rd }re (hBUhCj_ ubaubjĶ)rf }rg (hBUhM}rh (hO]hP]hQ]hR]hU]uhCj[ hY]ri hu)rj }rk (hBXFalsehM}rl (hO]hP]hQ]hR]hU]uhCjf hY]rm h›)rn }ro (hBX ``False``hCjj hIhJhKh£hM}rp (hO]hP]hQ]hR]hU]uhWNhXhhY]rq hbXFalserr …rs }rt (hBUhINhWNhXhhCjn ubaubahKhyubahKjŻubehKjŽubaubhu)ru }rv (hBXForce 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.hCjS hIhJhKhyhM}rw (hO]hP]hQ]hR]hU]uhWMÕhXhhY]rx (hbXœ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 ry …rz }r{ (hBXœ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 hINhWNhXhhCju ubh›)r| }r} (hBX ``False``hM}r~ (hO]hP]hQ]hR]hU]uhCju hY]r hbXFalser€ …r }r‚ (hBUhCj| ubahKh£ubhbX\; furthermore, benchmarks are automatically enabled if they are requested as a built target.rƒ …r„ }r… (hBX\; furthermore, benchmarks are automatically enabled if they are requested as a built target.hINhWNhXhhCju ubeubhu)r† }r‡ (hBX^The command line variant of this flag is ``--enable-benchmarks`` and ``--disable-benchmarks``.hCjS hIhJhKhyhM}rˆ (hO]hP]hQ]hR]hU]uhWMŚhXhhY]r‰ (hbX)The command line variant of this flag is rŠ …r‹ }rŒ (hBX)The command line variant of this flag is hINhWNhXhhCj† ubh›)r }rŽ (hBX``--enable-benchmarks``hM}r (hO]hP]hQ]hR]hU]uhCj† hY]r hbX--enable-benchmarksr‘ …r’ }r“ (hBUhCj ubahKh£ubhbX and r” …r• }r– (hBX and hINhWNhXhhCj† ubh›)r— }r˜ (hBX``--disable-benchmarks``hM}r™ (hO]hP]hQ]hR]hU]uhCj† hY]rš hbX--disable-benchmarksr› …rœ }r (hBUhCj— ubahKh£ubhbX.…rž }rŸ (hBX.hINhWNhXhhCj† ubeubeubeubjw)r  }r” (hBUhCj™hIhJhKjzhM}r¢ (hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r£ }r¤ (hBUhCj™hIhJhKjhM}r„ (j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr¦ j…j¦ uhWNhXhhY]r§ (j‡)rØ }r© (hBX3extra-prog-path: paths (newline or comma separated)hCj£ hIhJhKjŠhM}rŖ (hR]r« Xcfg-field-extra-prog-pathr¬ ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r­ (jw)r® }rÆ (hBUhCjØ hIhJhKjzhM}r° (hR]hQ]hO]hP]hU]Uentries]r± (j”X&extra-prog-path ; cabal project optionj¬ UNtr² auhWNhXhhY]ubj–)r³ }r“ (hBXextra-prog-pathrµ hCjØ hIhJhKjšhM}r¶ (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r· hbXextra-prog-pathrø …r¹ }rŗ (hBUhINhWNhXhhCj³ ubaubj )r» }r¼ (hBj£hCjØ hIhJhKj¤hM}r½ (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¾ hbX: ræ …rĄ }rĮ (hBUhINhWNhXhhCj» ubaubjŖ)rĀ }rĆ (hBX"paths (newline or comma separated)hCjØ hIhJhKj­hM}rÄ (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÅ hbX"paths (newline or comma separated)rĘ …rĒ }rČ (hBUhINhWNhXhhCjĀ ubaubeubj‡)rÉ }rŹ (hBX--extra-prog-path=PATHhCj£ hIhJhKjŠhM}rĖ (hR]rĢ Xcfg-flag---extra-prog-pathrĶ ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĪ (jw)rĻ }rŠ (hBUhCjÉ hIhJhKjzhM}rŃ (hR]hQ]hO]hP]hU]Uentries]rŅ (j”X'--extra-prog-path; cabal project optionjĶ UNtrÓ auhWNhXhhY]ubj–)rŌ }rÕ (hBX--extra-prog-pathrÖ hCjÉ hIhJhKjšhM}r× (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŲ hbX--extra-prog-pathrŁ …rŚ }rŪ (hBUhINhWNhXhhCjŌ ubaubj )rÜ }rŻ (hBX=PATHhCjÉ hIhJhKj¤hM}rŽ (jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rß hbX=PATHrą …rį }rā (hBUhINhWNhXhhCjÜ ubaubeubj³)rć }rä (hBUhCj£ hIhJhKj¶hM}rå (hO]hP]hQ]hR]hU]uhWNhXhhY]rę (j¹)rē }rč (hBUhCjć hIhJhKj¼hM}ré (hO]hP]hQ]hR]hU]uhWNhXhhY]rź jæ)rė }rģ (hBUhCjē hIhJhKjŽhM}rķ (hO]hP]hQ]hR]hU]uhWNhXhhY]rī (jÄ)rļ }rš (hBjæhCjė hIhJhKjĒhM}rń (hO]hP]hQ]hR]hU]uhWKhY]rņ hbXSinceró …rō }rõ (hBUhCjļ ubaubjĶ)rö }r÷ (hBU Cabal 1.18rų hM}rł (hO]hP]hQ]hR]hU]uhCjė hY]rś hu)rū }rü (hBjų hM}rż (hO]hP]hQ]hR]hU]uhCjö hY]rž hbX Cabal 1.18r’ …r!}r!(hBUhCjū ubahKhyubahKjŻubeubaubhu)r!}r!(hBXA 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.hCjć hIhJhKhyhM}r!(hO]hP]hQ]hR]hU]uhWMāhXhhY]r!(hbXoA list of directories to search for extra required programs. Most users should not need this, as programs like r!…r!}r!(hBXoA list of directories to search for extra required programs. Most users should not need this, as programs like hINhWNhXhhCj!ubh›)r !}r !(hBX ``happy``hM}r !(hO]hP]hQ]hR]hU]uhCj!hY]r !hbXhappyr !…r!}r!(hBUhCj !ubahKh£ubhbX and r!…r!}r!(hBX and hINhWNhXhhCj!ubh›)r!}r!(hBX``alex``hM}r!(hO]hP]hQ]hR]hU]uhCj!hY]r!hbXalexr!…r!}r!(hBUhCj!ubahKh£ubhbXP will automatically be installed and added to the path. This can be useful if a r!…r!}r!(hBXP will automatically be installed and added to the path. This can be useful if a hINhWNhXhhCj!ubh›)r!}r!(hBX ``Custom``hM}r!(hO]hP]hQ]hR]hU]uhCj!hY]r !hbXCustomr!!…r"!}r#!(hBUhCj!ubahKh£ubhbX0 setup script relies on an exotic extra program.r$!…r%!}r&!(hBX0 setup script relies on an exotic extra program.hINhWNhXhhCj!ubeubhu)r'!}r(!(hBXkThe command line variant of this flag is ``--extra-prog-path=PATH``, which can be specified multiple times.hCjć hIhJhKhyhM}r)!(hO]hP]hQ]hR]hU]uhWMčhXhhY]r*!(hbX)The command line variant of this flag is r+!…r,!}r-!(hBX)The command line variant of this flag is hINhWNhXhhCj'!ubh›)r.!}r/!(hBX``--extra-prog-path=PATH``hM}r0!(hO]hP]hQ]hR]hU]uhCj'!hY]r1!hbX--extra-prog-path=PATHr2!…r3!}r4!(hBUhCj.!ubahKh£ubhbX(, which can be specified multiple times.r5!…r6!}r7!(hBX(, which can be specified multiple times.hINhWNhXhhCj'!ubeubeubeubjw)r8!}r9!(hBUhCj™hIhJhKjzhM}r:!(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r;!}r!j…j>!uhWNhXhhY]r?!(j‡)r@!}rA!(hBXrun-tests: booleanhCj;!hIhJhKjŠhM}rB!(hR]rC!Xcfg-field-run-testsrD!ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rE!(jw)rF!}rG!(hBUhCj@!hIhJhKjzhM}rH!(hR]hQ]hO]hP]hU]Uentries]rI!(j”X run-tests ; cabal project optionjD!UNtrJ!auhWNhXhhY]ubj–)rK!}rL!(hBX run-testsrM!hCj@!hIhJhKjšhM}rN!(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rO!hbX run-testsrP!…rQ!}rR!(hBUhINhWNhXhhCjK!ubaubj )rS!}rT!(hBj£hCj@!hIhJhKj¤hM}rU!(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rV!hbX: rW!…rX!}rY!(hBUhINhWNhXhhCjS!ubaubjŖ)rZ!}r[!(hBXbooleanhCj@!hIhJhKj­hM}r\!(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r]!hbXbooleanr^!…r_!}r`!(hBUhINhWNhXhhCjZ!ubaubeubj‡)ra!}rb!(hBX --run-testsrc!hCj;!hIhJhKjŠhM}rd!(hR]re!Xcfg-flag---run-testsrf!ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rg!(jw)rh!}ri!(hBUhCja!hIhJhKjzhM}rj!(hR]hQ]hO]hP]hU]Uentries]rk!(j”X!--run-tests; cabal project optionjf!UNtrl!auhWNhXhhY]ubj–)rm!}rn!(hBjc!hCja!hIhJhKjšhM}ro!(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rp!hbX --run-testsrq!…rr!}rs!(hBUhINhWNhXhhCjm!ubaubj )rt!}ru!(hBU hCja!hIhJhKj¤hM}rv!(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rw!hbX …rx!}ry!(hBUhINhWNhXhhCjt!ubaubeubj³)rz!}r{!(hBUhCj;!hIhJhKj¶hM}r|!(hO]hP]hQ]hR]hU]uhWNhXhhY]r}!(j¹)r~!}r!(hBUhCjz!hIhJhKj¼hM}r€!(hO]hP]hQ]hR]hU]uhWNhXhhY]r!jæ)r‚!}rƒ!(hBUhM}r„!(hO]hP]hQ]hR]hU]uhCj~!hY]r…!(jÄ)r†!}r‡!(hBX Default valuehCj‚!hIhJhKjĒhM}rˆ!(hO]hP]hQ]hR]hU]uhWKhY]r‰!hbX Default valuerŠ!…r‹!}rŒ!(hBUhCj†!ubaubjĶ)r!}rŽ!(hBUhM}r!(hO]hP]hQ]hR]hU]uhCj‚!hY]r!hu)r‘!}r’!(hBXFalsehM}r“!(hO]hP]hQ]hR]hU]uhCj!hY]r”!h›)r•!}r–!(hBX ``False``hCj‘!hIhJhKh£hM}r—!(hO]hP]hQ]hR]hU]uhWNhXhhY]r˜!hbXFalser™!…rš!}r›!(hBUhINhWNhXhhCj•!ubaubahKhyubahKjŻubehKjŽubaubhu)rœ!}r!(hBX¾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ž!hCjz!hIhJhKhyhM}rŸ!(hO]hP]hQ]hR]hU]uhWMńhXhhY]r !hbXĀ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£!(hBjž!hINhWNhXhhCjœ!ubaubcdocutils.nodes warning r¤!)r„!}r¦!(hBXOne 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.hCjz!hIhJhKUwarningr§!hM}rØ!(hO]hP]hQ]hR]hU]uhWNhXhhY]r©!hu)rŖ!}r«!(hBXOne 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.hCj„!hIhJhKhyhM}r¬!(hO]hP]hQ]hR]hU]uhWM÷hY]r­!(hbXOne deficiency: the r®!…rÆ!}r°!(hBXOne deficiency: the hCjŖ!ubj[)r±!}r²!(hBX:cfg-field:`run-tests`r³!hCjŖ!hIhJhKj_hM}r“!(UreftypeX cfg-fieldjaˆjbX run-testsU refdomainXcabalrµ!hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM÷hY]r¶!h›)r·!}rø!(hBj³!hM}r¹!(hO]hP]rŗ!(jljµ!Xcabal-cfg-fieldr»!ehQ]hR]hU]uhCj±!hY]r¼!hbX run-testsr½!…r¾!}ræ!(hBUhCj·!ubahKh£ubaubhbX_ setting of a package is NOT recorded as part of the hash, so if you install something without rĄ!…rĮ!}rĀ!(hBX_ setting of a package is NOT recorded as part of the hash, so if you install something without hCjŖ!ubj[)rĆ!}rÄ!(hBX:cfg-field:`run-tests`rÅ!hCjŖ!hIhJhKj_hM}rĘ!(UreftypeX cfg-fieldjaˆjbX run-testsU refdomainXcabalrĒ!hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM÷hY]rČ!h›)rÉ!}rŹ!(hBjÅ!hM}rĖ!(hO]hP]rĢ!(jljĒ!Xcabal-cfg-fieldrĶ!ehQ]hR]hU]uhCjĆ!hY]rĪ!hbX run-testsrĻ!…rŠ!}rŃ!(hBUhCjÉ!ubahKh£ubaubhbX and then turn on rŅ!…rÓ!}rŌ!(hBX and then turn on hCjŖ!ubh›)rÕ!}rÖ!(hBX ``run-tests``hM}r×!(hO]hP]hQ]hR]hU]uhCjŖ!hY]rŲ!hbX run-testsrŁ!…rŚ!}rŪ!(hBUhCjÕ!ubahKh£ubhbX], we wonā€™t subsequently test the package. If this is causing you problems, give us a shout.rÜ!…rŻ!}rŽ!(hBX[, we won't subsequently test the package. If this is causing you problems, give us a shout.hCjŖ!ubeubaubhu)rß!}rą!(hBX9The command line variant of this flag is ``--run-tests``.hCjz!hIhJhKhyhM}rį!(hO]hP]hQ]hR]hU]uhWMżhXhhY]rā!(hbX)The command line variant of this flag is rć!…rä!}rå!(hBX)The command line variant of this flag is hINhWNhXhhCjß!ubh›)rę!}rē!(hBX``--run-tests``hM}rč!(hO]hP]hQ]hR]hU]uhCjß!hY]ré!hbX --run-testsrź!…rė!}rģ!(hBUhCję!ubahKh£ubhbX.…rķ!}rī!(hBX.hINhWNhXhhCjß!ubeubeubeubhD)rļ!}rš!(hBUhCj™hIhJhKhLhM}rń!(hO]hP]hQ]hR]rņ!jā ahU]ró!hauhWMhXhhY]rō!(h[)rõ!}rö!(hBXObject code optionsr÷!hCjļ!hIhJhKh_hM}rų!(hO]hP]hQ]hR]hU]uhWMhXhhY]rł!hbXObject code optionsrś!…rū!}rü!(hBj÷!hINhWNhXhhCjõ!ubaubjw)rż!}rž!(hBUhCjļ!hIhJhKjzhM}r’!(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r"}r"(hBUhCjļ!hIhJhKjhM}r"(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr"j…j"uhWNhXhhY]r"(j‡)r"}r"(hBXdebug-info: integerhCj"hIhJhKjŠhM}r"(hR]r"Xcfg-field-debug-infor "ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r "(jw)r "}r "(hBUhCj"hIhJhKjzhM}r "(hR]hQ]hO]hP]hU]Uentries]r"(j”X!debug-info ; cabal project optionj "UNtr"auhWNhXhhY]ubj–)r"}r"(hBX debug-infor"hCj"hIhJhKjšhM}r"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r"hbX debug-infor"…r"}r"(hBUhINhWNhXhhCj"ubaubj )r"}r"(hBj£hCj"hIhJhKj¤hM}r"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r"hbX: r"…r"}r"(hBUhINhWNhXhhCj"ubaubjŖ)r"}r "(hBXintegerhCj"hIhJhKj­hM}r!"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r""hbXintegerr#"…r$"}r%"(hBUhINhWNhXhhCj"ubaubeubj‡)r&"}r'"(hBX--enable-debug-info=hCj"hIhJhKjŠhM}r("(hR]r)"Xcfg-flag---enable-debug-infor*"ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r+"(jw)r,"}r-"(hBUhCj&"hIhJhKjzhM}r."(hR]hQ]hO]hP]hU]Uentries]r/"(j”X)--enable-debug-info; cabal project optionj*"UNtr0"auhWNhXhhY]ubj–)r1"}r2"(hBX--enable-debug-infor3"hCj&"hIhJhKjšhM}r4"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r5"hbX--enable-debug-infor6"…r7"}r8"(hBUhINhWNhXhhCj1"ubaubj )r9"}r:"(hBX=āŸØnāŸ©hCj&"hIhJhKj¤hM}r;"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r<"hbX=āŸØnāŸ©r="…r>"}r?"(hBUhINhWNhXhhCj9"ubaubeubj‡)r@"}rA"(hBX--disable-debug-inforB"hCj"hIhJhKjŠhM}rC"(hR]rD"Xcfg-flag---disable-debug-inforE"ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rF"(jw)rG"}rH"(hBUhCj@"hIhJhKjzhM}rI"(hR]hQ]hO]hP]hU]Uentries]rJ"(j”X*--disable-debug-info; cabal project optionjE"UNtrK"auhWNhXhhY]ubj–)rL"}rM"(hBjB"hCj@"hIhJhKjšhM}rN"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rO"hbX--disable-debug-inforP"…rQ"}rR"(hBUhINhWNhXhhCjL"ubaubj )rS"}rT"(hBU hCj@"hIhJhKj¤hM}rU"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rV"hbX …rW"}rX"(hBUhINhWNhXhhCjS"ubaubeubj³)rY"}rZ"(hBUhCj"hIhJhKj¶hM}r["(hO]hP]hQ]hR]hU]uhWNhXhhY]r\"(j¹)r]"}r^"(hBUhCjY"hIhJhKj¼hM}r_"(hO]hP]hQ]hR]hU]uhWNhXhhY]r`"(jæ)ra"}rb"(hBUhCj]"hIhJhKjŽhM}rc"(hO]hP]hQ]hR]hU]uhWNhXhhY]rd"(jÄ)re"}rf"(hBjæhCja"hIhJhKjĒhM}rg"(hO]hP]hQ]hR]hU]uhWKhY]rh"hbXSinceri"…rj"}rk"(hBUhCje"ubaubjĶ)rl"}rm"(hBU Cabal 1.22rn"hM}ro"(hO]hP]hQ]hR]hU]uhCja"hY]rp"hu)rq"}rr"(hBjn"hM}rs"(hO]hP]hQ]hR]hU]uhCjl"hY]rt"hbX Cabal 1.22ru"…rv"}rw"(hBUhCjq"ubahKhyubahKjŻubeubjæ)rx"}ry"(hBUhM}rz"(hO]hP]hQ]hR]hU]uhCj]"hY]r{"(jÄ)r|"}r}"(hBX Default valuehCjx"hIhJhKjĒhM}r~"(hO]hP]hQ]hR]hU]uhWKhY]r"hbX Default valuer€"…r"}r‚"(hBUhCj|"ubaubjĶ)rƒ"}r„"(hBUhM}r…"(hO]hP]hQ]hR]hU]uhCjx"hY]r†"hu)r‡"}rˆ"(hBXFalsehM}r‰"(hO]hP]hQ]hR]hU]uhCjƒ"hY]rŠ"hbXFalser‹"…rŒ"}r"(hBXFalsehINhWNhXhhCj‡"ubahKhyubahKjŻubehKjŽubeubhu)rŽ"}r"(hBXķ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.hCjY"hIhJhKhyhM}r"(hO]hP]hQ]hR]hU]uhWM hXhhY]r‘"(hbXjIf the compiler (e.g., GHC 7.10 and later) supports outputing OS native debug info (e.g., DWARF), setting r’"…r“"}r”"(hBXjIf the compiler (e.g., GHC 7.10 and later) supports outputing OS native debug info (e.g., DWARF), setting hINhWNhXhhCjŽ"ubh›)r•"}r–"(hBX``debug-info: True``hM}r—"(hO]hP]hQ]hR]hU]uhCjŽ"hY]r˜"hbXdebug-info: Truer™"…rš"}r›"(hBUhCj•"ubahKh£ubhbX5 will instruct it to do so. See the GHC wiki page on rœ"…r"}rž"(hBX5 will instruct it to do so. See the GHC wiki page on hINhWNhXhhCjŽ"ubji)rŸ"}r "(hBXDWARFhM}r”"(UrefuriX*http://ghc.haskell.org/trac/ghc/wiki/DWARFhR]hQ]hO]hP]hU]Uinternal‰uhCjŽ"hY]r¢"hbXDWARFr£"…r¤"}r„"(hBUhCjŸ"ubahKjrubhbX) for more information about this feature.r¦"…r§"}rØ"(hBX) for more information about this feature.hINhWNhXhhCjŽ"ubeubhu)r©"}rŖ"(hBXT(This field also accepts numeric syntax, but until GHC 8.2 this didn't do anything.)r«"hCjY"hIhJhKhyhM}r¬"(hO]hP]hQ]hR]hU]uhWMhXhhY]r­"hbXV(This field also accepts numeric syntax, but until GHC 8.2 this didnā€™t do anything.)r®"…rÆ"}r°"(hBj«"hINhWNhXhhCj©"ubaubhu)r±"}r²"(hBX^The command line variant of this flag is ``--enable-debug-info`` and ``--disable-debug-info``.hCjY"hIhJhKhyhM}r³"(hO]hP]hQ]hR]hU]uhWMhXhhY]r“"(hbX)The command line variant of this flag is rµ"…r¶"}r·"(hBX)The command line variant of this flag is hINhWNhXhhCj±"ubh›)rø"}r¹"(hBX``--enable-debug-info``hM}rŗ"(hO]hP]hQ]hR]hU]uhCj±"hY]r»"hbX--enable-debug-infor¼"…r½"}r¾"(hBUhCjø"ubahKh£ubhbX and ræ"…rĄ"}rĮ"(hBX and hINhWNhXhhCj±"ubh›)rĀ"}rĆ"(hBX``--disable-debug-info``hM}rÄ"(hO]hP]hQ]hR]hU]uhCj±"hY]rÅ"hbX--disable-debug-inforĘ"…rĒ"}rČ"(hBUhCjĀ"ubahKh£ubhbX.…rÉ"}rŹ"(hBX.hINhWNhXhhCj±"ubeubeubeubjw)rĖ"}rĢ"(hBUhCjļ!hIhJhKjzhM}rĶ"(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rĪ"}rĻ"(hBUhCjļ!hIhJhKjhM}rŠ"(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrŃ"j…jŃ"uhWNhXhhY]rŅ"(j‡)rÓ"}rŌ"(hBXsplit-sections: booleanhCjĪ"hIhJhKjŠhM}rÕ"(hR]rÖ"Xcfg-field-split-sectionsr×"ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŲ"(jw)rŁ"}rŚ"(hBUhCjÓ"hIhJhKjzhM}rŪ"(hR]hQ]hO]hP]hU]Uentries]rÜ"(j”X%split-sections ; cabal project optionj×"UNtrŻ"auhWNhXhhY]ubj–)rŽ"}rß"(hBXsplit-sectionsrą"hCjÓ"hIhJhKjšhM}rį"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rā"hbXsplit-sectionsrć"…rä"}rå"(hBUhINhWNhXhhCjŽ"ubaubj )rę"}rē"(hBj£hCjÓ"hIhJhKj¤hM}rč"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ré"hbX: rź"…rė"}rģ"(hBUhINhWNhXhhCję"ubaubjŖ)rķ"}rī"(hBXbooleanhCjÓ"hIhJhKj­hM}rļ"(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rš"hbXbooleanrń"…rņ"}ró"(hBUhINhWNhXhhCjķ"ubaubeubj‡)rō"}rõ"(hBX--enable-split-sectionsrö"hCjĪ"hIhJhKjŠhM}r÷"(hR]rų"X cfg-flag---enable-split-sectionsrł"ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rś"(jw)rū"}rü"(hBUhCjō"hIhJhKjzhM}rż"(hR]hQ]hO]hP]hU]Uentries]rž"(j”X---enable-split-sections; cabal project optionjł"UNtr’"auhWNhXhhY]ubj–)r#}r#(hBjö"hCjō"hIhJhKjšhM}r#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r#hbX--enable-split-sectionsr#…r#}r#(hBUhINhWNhXhhCj#ubaubj )r#}r#(hBU hCjō"hIhJhKj¤hM}r #(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r #hbX …r #}r #(hBUhINhWNhXhhCj#ubaubeubj‡)r #}r#(hBX--disable-split-sectionsr#hCjĪ"hIhJhKjŠhM}r#(hR]r#X!cfg-flag---disable-split-sectionsr#ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r#(jw)r#}r#(hBUhCj #hIhJhKjzhM}r#(hR]hQ]hO]hP]hU]Uentries]r#(j”X.--disable-split-sections; cabal project optionj#UNtr#auhWNhXhhY]ubj–)r#}r#(hBj#hCj #hIhJhKjšhM}r#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r#hbX--disable-split-sectionsr#…r#}r#(hBUhINhWNhXhhCj#ubaubj )r #}r!#(hBU hCj #hIhJhKj¤hM}r"#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r##hbX …r$#}r%#(hBUhINhWNhXhhCj #ubaubeubj³)r&#}r'#(hBUhCjĪ"hIhJhKj¶hM}r(#(hO]hP]hQ]hR]hU]uhWNhXhhY]r)#(j¹)r*#}r+#(hBUhCj&#hIhJhKj¼hM}r,#(hO]hP]hQ]hR]hU]uhWNhXhhY]r-#(jæ)r.#}r/#(hBUhCj*#hIhJhKjŽhM}r0#(hO]hP]hQ]hR]hU]uhWNhXhhY]r1#(jÄ)r2#}r3#(hBjæhCj.#hIhJhKjĒhM}r4#(hO]hP]hQ]hR]hU]uhWKhY]r5#hbXSincer6#…r7#}r8#(hBUhCj2#ubaubjĶ)r9#}r:#(hBU Cabal 2.1r;#hM}r<#(hO]hP]hQ]hR]hU]uhCj.#hY]r=#hu)r>#}r?#(hBj;#hM}r@#(hO]hP]hQ]hR]hU]uhCj9#hY]rA#hbX Cabal 2.1rB#…rC#}rD#(hBUhCj>#ubahKhyubahKjŻubeubjæ)rE#}rF#(hBUhM}rG#(hO]hP]hQ]hR]hU]uhCj*#hY]rH#(jÄ)rI#}rJ#(hBX Default valuehCjE#hIhJhKjĒhM}rK#(hO]hP]hQ]hR]hU]uhWKhY]rL#hbX Default valuerM#…rN#}rO#(hBUhCjI#ubaubjĶ)rP#}rQ#(hBUhM}rR#(hO]hP]hQ]hR]hU]uhCjE#hY]rS#hu)rT#}rU#(hBXFalsehM}rV#(hO]hP]hQ]hR]hU]uhCjP#hY]rW#hbXFalserX#…rY#}rZ#(hBXFalsehINhWNhXhhCjT#ubahKhyubahKjŻubehKjŽubeubhu)r[#}r\#(hBX3Use 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.hCj&#hIhJhKhyhM}r]#(hO]hP]hQ]hR]hU]uhWMhXhhY]r^#(hbX Use the GHC r_#…r`#}ra#(hBX Use the GHC hINhWNhXhhCj[#ubh›)rb#}rc#(hBX``-split-sections``hM}rd#(hO]hP]hQ]hR]hU]uhCj[#hY]re#hbX-split-sectionsrf#…rg#}rh#(hBUhCjb#ubahKh£ubhbX 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.ri#…rj#}rk#(hBX 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.hINhWNhXhhCj[#ubeubhu)rl#}rm#(hBX/This feature is supported by GHC 8.0 and later.rn#hCj&#hIhJhKhyhM}ro#(hO]hP]hQ]hR]hU]uhWM#hXhhY]rp#hbX/This feature is supported by GHC 8.0 and later.rq#…rr#}rs#(hBjn#hINhWNhXhhCjl#ubaubhu)rt#}ru#(hBXfThe command line variant of this flag is ``--enable-split-sections`` and ``--disable-split-sections``.hCj&#hIhJhKhyhM}rv#(hO]hP]hQ]hR]hU]uhWM%hXhhY]rw#(hbX)The command line variant of this flag is rx#…ry#}rz#(hBX)The command line variant of this flag is hINhWNhXhhCjt#ubh›)r{#}r|#(hBX``--enable-split-sections``hM}r}#(hO]hP]hQ]hR]hU]uhCjt#hY]r~#hbX--enable-split-sectionsr#…r€#}r#(hBUhCj{#ubahKh£ubhbX and r‚#…rƒ#}r„#(hBX and hINhWNhXhhCjt#ubh›)r…#}r†#(hBX``--disable-split-sections``hM}r‡#(hO]hP]hQ]hR]hU]uhCjt#hY]rˆ#hbX--disable-split-sectionsr‰#…rŠ#}r‹#(hBUhCj…#ubahKh£ubhbX.…rŒ#}r#(hBX.hINhWNhXhhCjt#ubeubeubeubjw)rŽ#}r#(hBUhCjļ!hIhJhKjzhM}r#(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r‘#}r’#(hBUhCjļ!hIhJhKjhM}r“#(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr”#j…j”#uhWNhXhhY]r•#(j‡)r–#}r—#(hBXsplit-objs: booleanhCj‘#hIhJhKjŠhM}r˜#(hR]r™#Xcfg-field-split-objsrš#ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r›#(jw)rœ#}r#(hBUhCj–#hIhJhKjzhM}rž#(hR]hQ]hO]hP]hU]Uentries]rŸ#(j”X!split-objs ; cabal project optionjš#UNtr #auhWNhXhhY]ubj–)r”#}r¢#(hBX split-objsr£#hCj–#hIhJhKjšhM}r¤#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r„#hbX split-objsr¦#…r§#}rØ#(hBUhINhWNhXhhCj”#ubaubj )r©#}rŖ#(hBj£hCj–#hIhJhKj¤hM}r«#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¬#hbX: r­#…r®#}rÆ#(hBUhINhWNhXhhCj©#ubaubjŖ)r°#}r±#(hBXbooleanhCj–#hIhJhKj­hM}r²#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r³#hbXbooleanr“#…rµ#}r¶#(hBUhINhWNhXhhCj°#ubaubeubj‡)r·#}rø#(hBX--enable-split-objsr¹#hCj‘#hIhJhKjŠhM}rŗ#(hR]r»#Xcfg-flag---enable-split-objsr¼#ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r½#(jw)r¾#}ræ#(hBUhCj·#hIhJhKjzhM}rĄ#(hR]hQ]hO]hP]hU]Uentries]rĮ#(j”X)--enable-split-objs; cabal project optionj¼#UNtrĀ#auhWNhXhhY]ubj–)rĆ#}rÄ#(hBj¹#hCj·#hIhJhKjšhM}rÅ#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĘ#hbX--enable-split-objsrĒ#…rČ#}rÉ#(hBUhINhWNhXhhCjĆ#ubaubj )rŹ#}rĖ#(hBU hCj·#hIhJhKj¤hM}rĢ#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĶ#hbX …rĪ#}rĻ#(hBUhINhWNhXhhCjŹ#ubaubeubj‡)rŠ#}rŃ#(hBX--disable-split-objsrŅ#hCj‘#hIhJhKjŠhM}rÓ#(hR]rŌ#Xcfg-flag---disable-split-objsrÕ#ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rÖ#(jw)r×#}rŲ#(hBUhCjŠ#hIhJhKjzhM}rŁ#(hR]hQ]hO]hP]hU]Uentries]rŚ#(j”X*--disable-split-objs; cabal project optionjÕ#UNtrŪ#auhWNhXhhY]ubj–)rÜ#}rŻ#(hBjŅ#hCjŠ#hIhJhKjšhM}rŽ#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rß#hbX--disable-split-objsrą#…rį#}rā#(hBUhINhWNhXhhCjÜ#ubaubj )rć#}rä#(hBU hCjŠ#hIhJhKj¤hM}rå#(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rę#hbX …rē#}rč#(hBUhINhWNhXhhCjć#ubaubeubj³)ré#}rź#(hBUhCj‘#hIhJhKj¶hM}rė#(hO]hP]hQ]hR]hU]uhWNhXhhY]rģ#(j¹)rķ#}rī#(hBUhCjé#hIhJhKj¼hM}rļ#(hO]hP]hQ]hR]hU]uhWNhXhhY]rš#jæ)rń#}rņ#(hBUhM}ró#(hO]hP]hQ]hR]hU]uhCjķ#hY]rō#(jÄ)rõ#}rö#(hBX Default valuehCjń#hIhJhKjĒhM}r÷#(hO]hP]hQ]hR]hU]uhWKhY]rų#hbX Default valuerł#…rś#}rū#(hBUhCjõ#ubaubjĶ)rü#}rż#(hBUhM}rž#(hO]hP]hQ]hR]hU]uhCjń#hY]r’#hu)r$}r$(hBXFalsehM}r$(hO]hP]hQ]hR]hU]uhCjü#hY]r$hbXFalser$…r$}r$(hBXFalsehINhWNhXhhCj$ubahKhyubahKjŻubehKjŽubaubhu)r$}r$(hBX6Use 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.hCjé#hIhJhKhyhM}r $(hO]hP]hQ]hR]hU]uhWM/hXhhY]r $(hbX Use the GHC r $…r $}r $(hBX Use the GHC hINhWNhXhhCj$ubh›)r$}r$(hBX``-split-objs``hM}r$(hO]hP]hQ]hR]hU]uhCj$hY]r$hbX -split-objsr$…r$}r$(hBUhCj$ubahKh£ubhbX 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.r$…r$}r$(hBX 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.hINhWNhXhhCj$ubeubhu)r$}r$(hBXcIt is generally recommend that you use ``split-sections`` instead of ``split-objs`` where possible.hCjé#hIhJhKhyhM}r$(hO]hP]hQ]hR]hU]uhWM5hXhhY]r$(hbX'It is generally recommend that you use r$…r$}r$(hBX'It is generally recommend that you use hINhWNhXhhCj$ubh›)r$}r $(hBX``split-sections``hM}r!$(hO]hP]hQ]hR]hU]uhCj$hY]r"$hbXsplit-sectionsr#$…r$$}r%$(hBUhCj$ubahKh£ubhbX instead of r&$…r'$}r($(hBX instead of hINhWNhXhhCj$ubh›)r)$}r*$(hBX``split-objs``hM}r+$(hO]hP]hQ]hR]hU]uhCj$hY]r,$hbX split-objsr-$…r.$}r/$(hBUhCj)$ubahKh£ubhbX where possible.r0$…r1$}r2$(hBX where possible.hINhWNhXhhCj$ubeubhu)r3$}r4$(hBX^The command line variant of this flag is ``--enable-split-objs`` and ``--disable-split-objs``.hCjé#hIhJhKhyhM}r5$(hO]hP]hQ]hR]hU]uhWM8hXhhY]r6$(hbX)The command line variant of this flag is r7$…r8$}r9$(hBX)The command line variant of this flag is hINhWNhXhhCj3$ubh›)r:$}r;$(hBX``--enable-split-objs``hM}r<$(hO]hP]hQ]hR]hU]uhCj3$hY]r=$hbX--enable-split-objsr>$…r?$}r@$(hBUhCj:$ubahKh£ubhbX and rA$…rB$}rC$(hBX and hINhWNhXhhCj3$ubh›)rD$}rE$(hBX``--disable-split-objs``hM}rF$(hO]hP]hQ]hR]hU]uhCj3$hY]rG$hbX--disable-split-objsrH$…rI$}rJ$(hBUhCjD$ubahKh£ubhbX.…rK$}rL$(hBX.hINhWNhXhhCj3$ubeubeubeubjw)rM$}rN$(hBUhCjļ!hIhJhKjzhM}rO$(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rP$}rQ$(hBUhCjļ!hIhJhKjhM}rR$(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrS$j…jS$uhWNhXhhY]rT$(j‡)rU$}rV$(hBXexecutable-stripping: booleanhCjP$hIhJhKjŠhM}rW$(hR]rX$Xcfg-field-executable-strippingrY$ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rZ$(jw)r[$}r\$(hBUhCjU$hIhJhKjzhM}r]$(hR]hQ]hO]hP]hU]Uentries]r^$(j”X+executable-stripping ; cabal project optionjY$UNtr_$auhWNhXhhY]ubj–)r`$}ra$(hBXexecutable-strippingrb$hCjU$hIhJhKjšhM}rc$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rd$hbXexecutable-strippingre$…rf$}rg$(hBUhINhWNhXhhCj`$ubaubj )rh$}ri$(hBj£hCjU$hIhJhKj¤hM}rj$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rk$hbX: rl$…rm$}rn$(hBUhINhWNhXhhCjh$ubaubjŖ)ro$}rp$(hBXbooleanhCjU$hIhJhKj­hM}rq$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rr$hbXbooleanrs$…rt$}ru$(hBUhINhWNhXhhCjo$ubaubeubj‡)rv$}rw$(hBX--enable-executable-strippingrx$hCjP$hIhJhKjŠhM}ry$(hR]rz$X&cfg-flag---enable-executable-strippingr{$ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r|$(jw)r}$}r~$(hBUhCjv$hIhJhKjzhM}r$(hR]hQ]hO]hP]hU]Uentries]r€$(j”X3--enable-executable-stripping; cabal project optionj{$UNtr$auhWNhXhhY]ubj–)r‚$}rƒ$(hBjx$hCjv$hIhJhKjšhM}r„$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r…$hbX--enable-executable-strippingr†$…r‡$}rˆ$(hBUhINhWNhXhhCj‚$ubaubj )r‰$}rŠ$(hBU hCjv$hIhJhKj¤hM}r‹$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŒ$hbX …r$}rŽ$(hBUhINhWNhXhhCj‰$ubaubeubj‡)r$}r$(hBX--disable-executable-strippingr‘$hCjP$hIhJhKjŠhM}r’$(hR]r“$X'cfg-flag---disable-executable-strippingr”$ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r•$(jw)r–$}r—$(hBUhCj$hIhJhKjzhM}r˜$(hR]hQ]hO]hP]hU]Uentries]r™$(j”X4--disable-executable-stripping; cabal project optionj”$UNtrš$auhWNhXhhY]ubj–)r›$}rœ$(hBj‘$hCj$hIhJhKjšhM}r$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rž$hbX--disable-executable-strippingrŸ$…r $}r”$(hBUhINhWNhXhhCj›$ubaubj )r¢$}r£$(hBU hCj$hIhJhKj¤hM}r¤$(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r„$hbX …r¦$}r§$(hBUhINhWNhXhhCj¢$ubaubeubj³)rØ$}r©$(hBUhCjP$hIhJhKj¶hM}rŖ$(hO]hP]hQ]hR]hU]uhWNhXhhY]r«$(j¹)r¬$}r­$(hBUhCjØ$hIhJhKj¼hM}r®$(hO]hP]hQ]hR]hU]uhWNhXhhY]rÆ$jæ)r°$}r±$(hBUhM}r²$(hO]hP]hQ]hR]hU]uhCj¬$hY]r³$(jÄ)r“$}rµ$(hBX Default valuehCj°$hIhJhKjĒhM}r¶$(hO]hP]hQ]hR]hU]uhWKhY]r·$hbX Default valuerø$…r¹$}rŗ$(hBUhCj“$ubaubjĶ)r»$}r¼$(hBUhM}r½$(hO]hP]hQ]hR]hU]uhCj°$hY]r¾$hu)ræ$}rĄ$(hBXTruehM}rĮ$(hO]hP]hQ]hR]hU]uhCj»$hY]rĀ$hbXTruerĆ$…rÄ$}rÅ$(hBXTruehINhWNhXhhCjæ$ubahKhyubahKjŻubehKjŽubaubhu)rĘ$}rĒ$(hBXÕ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.hCjØ$hIhJhKhyhM}rČ$(hO]hP]hQ]hR]hU]uhWMBhXhhY]rÉ$(hbX4When installing binary executable programs, run the rŹ$…rĖ$}rĢ$(hBX4When installing binary executable programs, run the hINhWNhXhhCjĘ$ubh›)rĶ$}rĪ$(hBX ``strip``hM}rĻ$(hO]hP]hQ]hR]hU]uhCjĘ$hY]rŠ$hbXstriprŃ$…rŅ$}rÓ$(hBUhCjĶ$ubahKh£ubhbX˜ 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Ö$(hBX˜ program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols.hINhWNhXhhCjĘ$ubeubhu)r×$}rŲ$(hBXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.rŁ$hCjØ$hIhJhKhyhM}rŚ$(hO]hP]hQ]hR]hU]uhWMGhXhhY]rŪ$hbXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.rÜ$…rŻ$}rŽ$(hBjŁ$hINhWNhXhhCj×$ubaubhu)rß$}rą$(hBXC(TODO: Check what happens if you combine this with ``debug-info``.)hCjØ$hIhJhKhyhM}rį$(hO]hP]hQ]hR]hU]uhWMJhXhhY]rā$(hbX3(TODO: Check what happens if you combine this with rć$…rä$}rå$(hBX3(TODO: Check what happens if you combine this with hINhWNhXhhCjß$ubh›)rę$}rē$(hBX``debug-info``hM}rč$(hO]hP]hQ]hR]hU]uhCjß$hY]ré$hbX debug-inforź$…rė$}rģ$(hBUhCję$ubahKh£ubhbX.)rķ$…rī$}rļ$(hBX.)hINhWNhXhhCjß$ubeubhu)rš$}rń$(hBXrThe command line variant of this flag is ``--enable-executable-stripping`` and ``--disable-executable-stripping``.hCjØ$hIhJhKhyhM}rņ$(hO]hP]hQ]hR]hU]uhWMLhXhhY]ró$(hbX)The command line variant of this flag is rō$…rõ$}rö$(hBX)The command line variant of this flag is hINhWNhXhhCjš$ubh›)r÷$}rų$(hBX!``--enable-executable-stripping``hM}rł$(hO]hP]hQ]hR]hU]uhCjš$hY]rś$hbX--enable-executable-strippingrū$…rü$}rż$(hBUhCj÷$ubahKh£ubhbX and rž$…r’$}r%(hBX and hINhWNhXhhCjš$ubh›)r%}r%(hBX"``--disable-executable-stripping``hM}r%(hO]hP]hQ]hR]hU]uhCjš$hY]r%hbX--disable-executable-strippingr%…r%}r%(hBUhCj%ubahKh£ubhbX.…r%}r %(hBX.hINhWNhXhhCjš$ubeubeubeubjw)r %}r %(hBUhCjļ!hIhJhKjzhM}r %(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r %}r%(hBUhCjļ!hIhJhKjhM}r%(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr%j…j%uhWNhXhhY]r%(j‡)r%}r%(hBXlibrary-stripping: booleanhCj %hIhJhKjŠhM}r%(hR]r%Xcfg-field-library-strippingr%ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r%(jw)r%}r%(hBUhCj%hIhJhKjzhM}r%(hR]hQ]hO]hP]hU]Uentries]r%(j”X(library-stripping ; cabal project optionj%UNtr%auhWNhXhhY]ubj–)r%}r%(hBXlibrary-strippingr%hCj%hIhJhKjšhM}r %(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r!%hbXlibrary-strippingr"%…r#%}r$%(hBUhINhWNhXhhCj%ubaubj )r%%}r&%(hBj£hCj%hIhJhKj¤hM}r'%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r(%hbX: r)%…r*%}r+%(hBUhINhWNhXhhCj%%ubaubjŖ)r,%}r-%(hBXbooleanhCj%hIhJhKj­hM}r.%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r/%hbXbooleanr0%…r1%}r2%(hBUhINhWNhXhhCj,%ubaubeubj‡)r3%}r4%(hBX--enable-library-strippingr5%hCj %hIhJhKjŠhM}r6%(hR]r7%X#cfg-flag---enable-library-strippingr8%ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r9%(jw)r:%}r;%(hBUhCj3%hIhJhKjzhM}r<%(hR]hQ]hO]hP]hU]Uentries]r=%(j”X0--enable-library-stripping; cabal project optionj8%UNtr>%auhWNhXhhY]ubj–)r?%}r@%(hBj5%hCj3%hIhJhKjšhM}rA%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rB%hbX--enable-library-strippingrC%…rD%}rE%(hBUhINhWNhXhhCj?%ubaubj )rF%}rG%(hBU hCj3%hIhJhKj¤hM}rH%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rI%hbX …rJ%}rK%(hBUhINhWNhXhhCjF%ubaubeubj‡)rL%}rM%(hBX--disable-library-strippingrN%hCj %hIhJhKjŠhM}rO%(hR]rP%X$cfg-flag---disable-library-strippingrQ%ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rR%(jw)rS%}rT%(hBUhCjL%hIhJhKjzhM}rU%(hR]hQ]hO]hP]hU]Uentries]rV%(j”X1--disable-library-stripping; cabal project optionjQ%UNtrW%auhWNhXhhY]ubj–)rX%}rY%(hBjN%hCjL%hIhJhKjšhM}rZ%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r[%hbX--disable-library-strippingr\%…r]%}r^%(hBUhINhWNhXhhCjX%ubaubj )r_%}r`%(hBU hCjL%hIhJhKj¤hM}ra%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rb%hbX …rc%}rd%(hBUhINhWNhXhhCj_%ubaubeubj³)re%}rf%(hBUhCj %hIhJhKj¶hM}rg%(hO]hP]hQ]hR]hU]uhWNhXhhY]rh%(j¹)ri%}rj%(hBUhCje%hIhJhKj¼hM}rk%(hO]hP]hQ]hR]hU]uhWNhXhhY]rl%jæ)rm%}rn%(hBUhCji%hIhJhKjŽhM}ro%(hO]hP]hQ]hR]hU]uhWNhXhhY]rp%(jÄ)rq%}rr%(hBjæhCjm%hIhJhKjĒhM}rs%(hO]hP]hQ]hR]hU]uhWKhY]rt%hbXSinceru%…rv%}rw%(hBUhCjq%ubaubjĶ)rx%}ry%(hBU Cabal 1.19rz%hM}r{%(hO]hP]hQ]hR]hU]uhCjm%hY]r|%hu)r}%}r~%(hBjz%hM}r%(hO]hP]hQ]hR]hU]uhCjx%hY]r€%hbX Cabal 1.19r%…r‚%}rƒ%(hBUhCj}%ubahKhyubahKjŻubeubaubhu)r„%}r…%(hBXŽWhen installing binary libraries, run the ``strip`` program on the binary, saving space on the file system. See also ``executable-stripping``.hCje%hIhJhKhyhM}r†%(hO]hP]hQ]hR]hU]uhWMVhXhhY]r‡%(hbX*When installing binary libraries, run the rˆ%…r‰%}rŠ%(hBX*When installing binary libraries, run the hINhWNhXhhCj„%ubh›)r‹%}rŒ%(hBX ``strip``hM}r%(hO]hP]hQ]hR]hU]uhCj„%hY]rŽ%hbXstripr%…r%}r‘%(hBUhCj‹%ubahKh£ubhbXB program on the binary, saving space on the file system. See also r’%…r“%}r”%(hBXB program on the binary, saving space on the file system. See also hINhWNhXhhCj„%ubh›)r•%}r–%(hBX``executable-stripping``hM}r—%(hO]hP]hQ]hR]hU]uhCj„%hY]r˜%hbXexecutable-strippingr™%…rš%}r›%(hBUhCj•%ubahKh£ubhbX.…rœ%}r%(hBX.hINhWNhXhhCj„%ubeubhu)rž%}rŸ%(hBXlThe command line variant of this flag is ``--enable-library-stripping`` and ``--disable-library-stripping``.hCje%hIhJhKhyhM}r %(hO]hP]hQ]hR]hU]uhWMZhXhhY]r”%(hbX)The command line variant of this flag is r¢%…r£%}r¤%(hBX)The command line variant of this flag is hINhWNhXhhCjž%ubh›)r„%}r¦%(hBX``--enable-library-stripping``hM}r§%(hO]hP]hQ]hR]hU]uhCjž%hY]rØ%hbX--enable-library-strippingr©%…rŖ%}r«%(hBUhCj„%ubahKh£ubhbX and r¬%…r­%}r®%(hBX and hINhWNhXhhCjž%ubh›)rÆ%}r°%(hBX``--disable-library-stripping``hM}r±%(hO]hP]hQ]hR]hU]uhCjž%hY]r²%hbX--disable-library-strippingr³%…r“%}rµ%(hBUhCjÆ%ubahKh£ubhbX.…r¶%}r·%(hBX.hINhWNhXhhCjž%ubeubeubeubeubhD)rø%}r¹%(hBUhCj™hIhJhKhLhM}rŗ%(hO]hP]hQ]hR]r»%jŻ ahU]r¼%hauhWM^hXhhY]r½%(h[)r¾%}ræ%(hBXExecutable optionsrĄ%hCjø%hIhJhKh_hM}rĮ%(hO]hP]hQ]hR]hU]uhWM^hXhhY]rĀ%hbXExecutable optionsrĆ%…rÄ%}rÅ%(hBjĄ%hINhWNhXhhCj¾%ubaubjw)rĘ%}rĒ%(hBUhCjø%hIhJhKjzhM}rČ%(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rÉ%}rŹ%(hBUhCjø%hIhJhKjhM}rĖ%(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrĢ%j…jĢ%uhWNhXhhY]rĶ%(j‡)rĪ%}rĻ%(hBXprogram-prefix: prefixhCjÉ%hIhJhKjŠhM}rŠ%(hR]rŃ%Xcfg-field-program-prefixrŅ%ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rÓ%(jw)rŌ%}rÕ%(hBUhCjĪ%hIhJhKjzhM}rÖ%(hR]hQ]hO]hP]hU]Uentries]r×%(j”X%program-prefix ; cabal project optionjŅ%UNtrŲ%auhWNhXhhY]ubj–)rŁ%}rŚ%(hBXprogram-prefixrŪ%hCjĪ%hIhJhKjšhM}rÜ%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŻ%hbXprogram-prefixrŽ%…rß%}rą%(hBUhINhWNhXhhCjŁ%ubaubj )rį%}rā%(hBj£hCjĪ%hIhJhKj¤hM}rć%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rä%hbX: rå%…rę%}rē%(hBUhINhWNhXhhCjį%ubaubjŖ)rč%}ré%(hBXprefixhCjĪ%hIhJhKj­hM}rź%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rė%hbXprefixrģ%…rķ%}rī%(hBUhINhWNhXhhCjč%ubaubeubj‡)rļ%}rš%(hBX--program-prefix=prefixhCjÉ%hIhJhKjŠhM}rń%(hR]rņ%Xcfg-flag---program-prefixró%ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rō%(jw)rõ%}rö%(hBUhCjļ%hIhJhKjzhM}r÷%(hR]hQ]hO]hP]hU]Uentries]rų%(j”X&--program-prefix; cabal project optionjó%UNtrł%auhWNhXhhY]ubj–)rś%}rū%(hBX--program-prefixrü%hCjļ%hIhJhKjšhM}rż%(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rž%hbX--program-prefixr’%…r&}r&(hBUhINhWNhXhhCjś%ubaubj )r&}r&(hBX=prefixhCjļ%hIhJhKj¤hM}r&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r&hbX=prefixr&…r&}r&(hBUhINhWNhXhhCj&ubaubeubj³)r &}r &(hBUhCjÉ%hIhJhKj¶hM}r &(hO]hP]hQ]hR]hU]uhWNhXhhY]r &(hu)r &}r&(hBX™[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.)hCj &hIhJhKhyhM}r&(hO]hP]hQ]hR]hU]uhWMdhXhhY]r&(hbX[STRIKEOUT:Prepend r&…r&}r&(hBX[STRIKEOUT:Prepend hINhWNhXhhCj &ubjŖ)r&}r&(hBX*prefix*hM}r&(hO]hP]hQ]hR]hU]uhCj &hY]r&hbXprefixr&…r&}r&(hBUhCj&ubahKj²ubhbX~ 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&(hBX~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)hINhWNhXhhCj &ubeubhu)r&}r&(hBX*prefix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``hCj &hIhJhKhyhM}r &(hO]hP]hQ]hR]hU]uhWMhhXhhY]r!&(jŖ)r"&}r#&(hBX*prefix*hM}r$&(hO]hP]hQ]hR]hU]uhCj&hY]r%&hbXprefixr&&…r'&}r(&(hBUhCj"&ubahKj²ubhbX+ may contain the following path variables: r)&…r*&}r+&(hBX+ may contain the following path variables: hINhWNhXhhCj&ubh›)r,&}r-&(hBX ``$pkgid``hM}r.&(hO]hP]hQ]hR]hU]uhCj&hY]r/&hbX$pkgidr0&…r1&}r2&(hBUhCj,&ubahKh£ubhbX, r3&…r4&}r5&(hBX, r6&hINhWNhXhhCj&ubh›)r7&}r8&(hBX``$pkg``hM}r9&(hO]hP]hQ]hR]hU]uhCj&hY]r:&hbX$pkgr;&…r<&}r=&(hBUhCj7&ubahKh£ubhbX, r>&…r?&}r@&(hBX, rA&hINhWNhXhhCj&ubh›)rB&}rC&(hBX ``$version``hM}rD&(hO]hP]hQ]hR]hU]uhCj&hY]rE&hbX$versionrF&…rG&}rH&(hBUhCjB&ubahKh£ubhbX, rI&…rJ&}rK&(hBX, hCj&ubh›)rL&}rM&(hBX ``$compiler``hM}rN&(hO]hP]hQ]hR]hU]uhCj&hY]rO&hbX $compilerrP&…rQ&}rR&(hBUhCjL&ubahKh£ubhbX, rS&…rT&}rU&(hBX, hCj&ubh›)rV&}rW&(hBX``$os``hM}rX&(hO]hP]hQ]hR]hU]uhCj&hY]rY&hbX$osrZ&…r[&}r\&(hBUhCjV&ubahKh£ubhbX, r]&…r^&}r_&(hBX, hCj&ubh›)r`&}ra&(hBX ``$arch``hM}rb&(hO]hP]hQ]hR]hU]uhCj&hY]rc&hbX$archrd&…re&}rf&(hBUhCj`&ubahKh£ubhbX, rg&…rh&}ri&(hBjA&hCj&ubh›)rj&}rk&(hBX``$abi``hM}rl&(hO]hP]hQ]hR]hU]uhCj&hY]rm&hbX$abirn&…ro&}rp&(hBUhCjj&ubahKh£ubhbX, rq&…rr&}rs&(hBj6&hCj&ubh›)rt&}ru&(hBX ``$abitag``hM}rv&(hO]hP]hQ]hR]hU]uhCj&hY]rw&hbX$abitagrx&…ry&}rz&(hBUhCjt&ubahKh£ubeubhu)r{&}r|&(hBXCThe command line variant of this flag is ``--program-prefix=foo-``.hCj &hIhJhKhyhM}r}&(hO]hP]hQ]hR]hU]uhWMlhXhhY]r~&(hbX)The command line variant of this flag is r&…r€&}r&(hBX)The command line variant of this flag is hINhWNhXhhCj{&ubh›)r‚&}rƒ&(hBX``--program-prefix=foo-``hM}r„&(hO]hP]hQ]hR]hU]uhCj{&hY]r…&hbX--program-prefix=foo-r†&…r‡&}rˆ&(hBUhCj‚&ubahKh£ubhbX.…r‰&}rŠ&(hBX.hINhWNhXhhCj{&ubeubeubeubjw)r‹&}rŒ&(hBUhCjø%hIhJhKjzhM}r&(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rŽ&}r&(hBUhCjø%hIhJhKjhM}r&(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr‘&j…j‘&uhWNhXhhY]r’&(j‡)r“&}r”&(hBXprogram-suffix: suffixhCjŽ&hIhJhKjŠhM}r•&(hR]r–&Xcfg-field-program-suffixr—&ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r˜&(jw)r™&}rš&(hBUhCj“&hIhJhKjzhM}r›&(hR]hQ]hO]hP]hU]Uentries]rœ&(j”X%program-suffix ; cabal project optionj—&UNtr&auhWNhXhhY]ubj–)rž&}rŸ&(hBXprogram-suffixr &hCj“&hIhJhKjšhM}r”&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¢&hbXprogram-suffixr£&…r¤&}r„&(hBUhINhWNhXhhCjž&ubaubj )r¦&}r§&(hBj£hCj“&hIhJhKj¤hM}rØ&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r©&hbX: rŖ&…r«&}r¬&(hBUhINhWNhXhhCj¦&ubaubjŖ)r­&}r®&(hBXsuffixhCj“&hIhJhKj­hM}rÆ&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r°&hbXsuffixr±&…r²&}r³&(hBUhINhWNhXhhCj­&ubaubeubj‡)r“&}rµ&(hBX--program-suffix=suffixhCjŽ&hIhJhKjŠhM}r¶&(hR]r·&Xcfg-flag---program-suffixrø&ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r¹&(jw)rŗ&}r»&(hBUhCj“&hIhJhKjzhM}r¼&(hR]hQ]hO]hP]hU]Uentries]r½&(j”X&--program-suffix; cabal project optionjø&UNtr¾&auhWNhXhhY]ubj–)ræ&}rĄ&(hBX--program-suffixrĮ&hCj“&hIhJhKjšhM}rĀ&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĆ&hbX--program-suffixrÄ&…rÅ&}rĘ&(hBUhINhWNhXhhCjæ&ubaubj )rĒ&}rČ&(hBX=suffixhCj“&hIhJhKj¤hM}rÉ&(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŹ&hbX=suffixrĖ&…rĢ&}rĶ&(hBUhINhWNhXhhCjĒ&ubaubeubj³)rĪ&}rĻ&(hBUhCjŽ&hIhJhKj¶hM}rŠ&(hO]hP]hQ]hR]hU]uhWNhXhhY]rŃ&(hu)rŅ&}rÓ&(hBX˜[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.)hCjĪ&hIhJhKhyhM}rŌ&(hO]hP]hQ]hR]hU]uhWMrhXhhY]rÕ&(hbX[STRIKEOUT:Append rÖ&…r×&}rŲ&(hBX[STRIKEOUT:Append hINhWNhXhhCjŅ&ubjŖ)rŁ&}rŚ&(hBX*suffix*hM}rŪ&(hO]hP]hQ]hR]hU]uhCjŅ&hY]rÜ&hbXsuffixrŻ&…rŽ&}rß&(hBUhCjŁ&ubahKj²ubhbX~ 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ā&(hBX~ to installed program names.] (Currently implemented in a silly and not useful way. If you need this to work give us a shout.)hINhWNhXhhCjŅ&ubeubhu)rć&}rä&(hBX«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``.hCjĪ&hIhJhKhyhM}rå&(hO]hP]hQ]hR]hU]uhWMvhXhhY]rę&(hbX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: rē&…rč&}ré&(hBXŽ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: hINhWNhXhhCjć&ubh›)rź&}rė&(hBX``program-suffix: $version``hM}rģ&(hO]hP]hQ]hR]hU]uhCjć&hY]rķ&hbXprogram-suffix: $versionrī&…rļ&}rš&(hBUhCjź&ubahKh£ubhbX.…rń&}rņ&(hBX.hINhWNhXhhCjć&ubeubhu)ró&}rō&(hBX*suffix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``hCjĪ&hIhJhKhyhM}rõ&(hO]hP]hQ]hR]hU]uhWMzhXhhY]rö&(jŖ)r÷&}rų&(hBX*suffix*hM}rł&(hO]hP]hQ]hR]hU]uhCjó&hY]rś&hbXsuffixrū&…rü&}rż&(hBUhCj÷&ubahKj²ubhbX+ may contain the following path variables: rž&…r’&}r'(hBX+ may contain the following path variables: hINhWNhXhhCjó&ubh›)r'}r'(hBX ``$pkgid``hM}r'(hO]hP]hQ]hR]hU]uhCjó&hY]r'hbX$pkgidr'…r'}r'(hBUhCj'ubahKh£ubhbX, r'…r '}r '(hBX, r 'hINhWNhXhhCjó&ubh›)r '}r '(hBX``$pkg``hM}r'(hO]hP]hQ]hR]hU]uhCjó&hY]r'hbX$pkgr'…r'}r'(hBUhCj 'ubahKh£ubhbX, r'…r'}r'(hBX, r'hINhWNhXhhCjó&ubh›)r'}r'(hBX ``$version``hM}r'(hO]hP]hQ]hR]hU]uhCjó&hY]r'hbX$versionr'…r'}r'(hBUhCj'ubahKh£ubhbX, r'…r'}r '(hBX, hCjó&ubh›)r!'}r"'(hBX ``$compiler``hM}r#'(hO]hP]hQ]hR]hU]uhCjó&hY]r$'hbX $compilerr%'…r&'}r''(hBUhCj!'ubahKh£ubhbX, r('…r)'}r*'(hBX, hCjó&ubh›)r+'}r,'(hBX``$os``hM}r-'(hO]hP]hQ]hR]hU]uhCjó&hY]r.'hbX$osr/'…r0'}r1'(hBUhCj+'ubahKh£ubhbX, r2'…r3'}r4'(hBX, hCjó&ubh›)r5'}r6'(hBX ``$arch``hM}r7'(hO]hP]hQ]hR]hU]uhCjó&hY]r8'hbX$archr9'…r:'}r;'(hBUhCj5'ubahKh£ubhbX, r<'…r='}r>'(hBj'hCjó&ubh›)r?'}r@'(hBX``$abi``hM}rA'(hO]hP]hQ]hR]hU]uhCjó&hY]rB'hbX$abirC'…rD'}rE'(hBUhCj?'ubahKh£ubhbX, rF'…rG'}rH'(hBj 'hCjó&ubh›)rI'}rJ'(hBX ``$abitag``hM}rK'(hO]hP]hQ]hR]hU]uhCjó&hY]rL'hbX$abitagrM'…rN'}rO'(hBUhCjI'ubahKh£ubeubhu)rP'}rQ'(hBXIThe command line variant of this flag is ``--program-suffix='$version'``.hCjĪ&hIhJhKhyhM}rR'(hO]hP]hQ]hR]hU]uhWM~hXhhY]rS'(hbX)The command line variant of this flag is rT'…rU'}rV'(hBX)The command line variant of this flag is hINhWNhXhhCjP'ubh›)rW'}rX'(hBX``--program-suffix='$version'``hM}rY'(hO]hP]hQ]hR]hU]uhCjP'hY]rZ'hbX--program-suffix='$version'r['…r\'}r]'(hBUhCjW'ubahKh£ubhbX.…r^'}r_'(hBX.hINhWNhXhhCjP'ubeubeubeubeubhD)r`'}ra'(hBUhCj™hIhJhKhLhM}rb'(hO]hP]hQ]hR]rc'ję ahU]rd'h$auhWM‚hXhhY]re'(h[)rf'}rg'(hBXDynamic linking optionsrh'hCj`'hIhJhKh_hM}ri'(hO]hP]hQ]hR]hU]uhWM‚hXhhY]rj'hbXDynamic linking optionsrk'…rl'}rm'(hBjh'hINhWNhXhhCjf'ubaubjw)rn'}ro'(hBUhCj`'hIhJhKjzhM}rp'(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rq'}rr'(hBUhCj`'hIhJhKjhM}rs'(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrt'j…jt'uhWNhXhhY]ru'(j‡)rv'}rw'(hBXshared: booleanhCjq'hIhJhKjŠhM}rx'(hR]ry'Xcfg-field-sharedrz'ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r{'(jw)r|'}r}'(hBUhCjv'hIhJhKjzhM}r~'(hR]hQ]hO]hP]hU]Uentries]r'(j”Xshared ; cabal project optionjz'UNtr€'auhWNhXhhY]ubj–)r'}r‚'(hBXsharedrƒ'hCjv'hIhJhKjšhM}r„'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r…'hbXsharedr†'…r‡'}rˆ'(hBUhINhWNhXhhCj'ubaubj )r‰'}rŠ'(hBj£hCjv'hIhJhKj¤hM}r‹'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŒ'hbX: r'…rŽ'}r'(hBUhINhWNhXhhCj‰'ubaubjŖ)r'}r‘'(hBXbooleanhCjv'hIhJhKj­hM}r’'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“'hbXbooleanr”'…r•'}r–'(hBUhINhWNhXhhCj'ubaubeubj‡)r—'}r˜'(hBX--enable-sharedr™'hCjq'hIhJhKjŠhM}rš'(hR]r›'Xcfg-flag---enable-sharedrœ'ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r'(jw)rž'}rŸ'(hBUhCj—'hIhJhKjzhM}r '(hR]hQ]hO]hP]hU]Uentries]r”'(j”X%--enable-shared; cabal project optionjœ'UNtr¢'auhWNhXhhY]ubj–)r£'}r¤'(hBj™'hCj—'hIhJhKjšhM}r„'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¦'hbX--enable-sharedr§'…rØ'}r©'(hBUhINhWNhXhhCj£'ubaubj )rŖ'}r«'(hBU hCj—'hIhJhKj¤hM}r¬'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r­'hbX …r®'}rÆ'(hBUhINhWNhXhhCjŖ'ubaubeubj‡)r°'}r±'(hBX--disable-sharedr²'hCjq'hIhJhKjŠhM}r³'(hR]r“'Xcfg-flag---disable-sharedrµ'ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r¶'(jw)r·'}rø'(hBUhCj°'hIhJhKjzhM}r¹'(hR]hQ]hO]hP]hU]Uentries]rŗ'(j”X&--disable-shared; cabal project optionjµ'UNtr»'auhWNhXhhY]ubj–)r¼'}r½'(hBj²'hCj°'hIhJhKjšhM}r¾'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ræ'hbX--disable-sharedrĄ'…rĮ'}rĀ'(hBUhINhWNhXhhCj¼'ubaubj )rĆ'}rÄ'(hBU hCj°'hIhJhKj¤hM}rÅ'(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĘ'hbX …rĒ'}rČ'(hBUhINhWNhXhhCjĆ'ubaubeubj³)rÉ'}rŹ'(hBUhCjq'hIhJhKj¶hM}rĖ'(hO]hP]hQ]hR]hU]uhWNhXhhY]rĢ'(j¹)rĶ'}rĪ'(hBUhCjÉ'hIhJhKj¼hM}rĻ'(hO]hP]hQ]hR]hU]uhWNhXhhY]rŠ'jæ)rŃ'}rŅ'(hBUhM}rÓ'(hO]hP]hQ]hR]hU]uhCjĶ'hY]rŌ'(jÄ)rÕ'}rÖ'(hBX Default valuehCjŃ'hIhJhKjĒhM}r×'(hO]hP]hQ]hR]hU]uhWKhY]rŲ'hbX Default valuerŁ'…rŚ'}rŪ'(hBUhCjÕ'ubaubjĶ)rÜ'}rŻ'(hBUhM}rŽ'(hO]hP]hQ]hR]hU]uhCjŃ'hY]rß'hu)rą'}rį'(hBXFalsehM}rā'(hO]hP]hQ]hR]hU]uhCjÜ'hY]rć'hbXFalserä'…rå'}rę'(hBXFalsehINhWNhXhhCją'ubahKhyubahKjŻubehKjŽubaubhu)rē'}rč'(hBXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.ré'hCjÉ'hIhJhKhyhM}rź'(hO]hP]hQ]hR]hU]uhWM‹hXhhY]rė'hbXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rģ'…rķ'}rī'(hBjé'hINhWNhXhhCjē'ubaubhu)rļ'}rš'(hBXVThe command line variant of this flag is ``--enable-shared`` and ``--disable-shared``.hCjÉ'hIhJhKhyhM}rń'(hO]hP]hQ]hR]hU]uhWMŽhXhhY]rņ'(hbX)The command line variant of this flag is ró'…rō'}rõ'(hBX)The command line variant of this flag is hINhWNhXhhCjļ'ubh›)rö'}r÷'(hBX``--enable-shared``hM}rų'(hO]hP]hQ]hR]hU]uhCjļ'hY]rł'hbX--enable-sharedrś'…rū'}rü'(hBUhCjö'ubahKh£ubhbX and rż'…rž'}r’'(hBX and hINhWNhXhhCjļ'ubh›)r(}r((hBX``--disable-shared``hM}r((hO]hP]hQ]hR]hU]uhCjļ'hY]r(hbX--disable-sharedr(…r(}r((hBUhCj(ubahKh£ubhbX.…r(}r((hBX.hINhWNhXhhCjļ'ubeubeubeubjw)r (}r ((hBUhCj`'hIhJhKjzhM}r ((hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r (}r ((hBUhCj`'hIhJhKjhM}r((j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr(j…j(uhWNhXhhY]r((j‡)r(}r((hBXexecutable-dynamic: booleanhCj (hIhJhKjŠhM}r((hR]r(Xcfg-field-executable-dynamicr(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r((jw)r(}r((hBUhCj(hIhJhKjzhM}r((hR]hQ]hO]hP]hU]Uentries]r((j”X)executable-dynamic ; cabal project optionj(UNtr(auhWNhXhhY]ubj–)r(}r((hBXexecutable-dynamicr(hCj(hIhJhKjšhM}r((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r (hbXexecutable-dynamicr!(…r"(}r#((hBUhINhWNhXhhCj(ubaubj )r$(}r%((hBj£hCj(hIhJhKj¤hM}r&((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r'(hbX: r((…r)(}r*((hBUhINhWNhXhhCj$(ubaubjŖ)r+(}r,((hBXbooleanhCj(hIhJhKj­hM}r-((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r.(hbXbooleanr/(…r0(}r1((hBUhINhWNhXhhCj+(ubaubeubj‡)r2(}r3((hBX--enable-executable-dynamicr4(hCj (hIhJhKjŠhM}r5((hR]r6(X$cfg-flag---enable-executable-dynamicr7(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r8((jw)r9(}r:((hBUhCj2(hIhJhKjzhM}r;((hR]hQ]hO]hP]hU]Uentries]r<((j”X1--enable-executable-dynamic; cabal project optionj7(UNtr=(auhWNhXhhY]ubj–)r>(}r?((hBj4(hCj2(hIhJhKjšhM}r@((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rA(hbX--enable-executable-dynamicrB(…rC(}rD((hBUhINhWNhXhhCj>(ubaubj )rE(}rF((hBU hCj2(hIhJhKj¤hM}rG((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rH(hbX …rI(}rJ((hBUhINhWNhXhhCjE(ubaubeubj‡)rK(}rL((hBX--disable-executable-dynamicrM(hCj (hIhJhKjŠhM}rN((hR]rO(X%cfg-flag---disable-executable-dynamicrP(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rQ((jw)rR(}rS((hBUhCjK(hIhJhKjzhM}rT((hR]hQ]hO]hP]hU]Uentries]rU((j”X2--disable-executable-dynamic; cabal project optionjP(UNtrV(auhWNhXhhY]ubj–)rW(}rX((hBjM(hCjK(hIhJhKjšhM}rY((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rZ(hbX--disable-executable-dynamicr[(…r\(}r]((hBUhINhWNhXhhCjW(ubaubj )r^(}r_((hBU hCjK(hIhJhKj¤hM}r`((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ra(hbX …rb(}rc((hBUhINhWNhXhhCj^(ubaubeubj³)rd(}re((hBUhCj (hIhJhKj¶hM}rf((hO]hP]hQ]hR]hU]uhWNhXhhY]rg((j¹)rh(}ri((hBUhCjd(hIhJhKj¼hM}rj((hO]hP]hQ]hR]hU]uhWNhXhhY]rk(jæ)rl(}rm((hBUhM}rn((hO]hP]hQ]hR]hU]uhCjh(hY]ro((jÄ)rp(}rq((hBX Default valuehCjl(hIhJhKjĒhM}rr((hO]hP]hQ]hR]hU]uhWKhY]rs(hbX Default valuert(…ru(}rv((hBUhCjp(ubaubjĶ)rw(}rx((hBUhM}ry((hO]hP]hQ]hR]hU]uhCjl(hY]rz(hu)r{(}r|((hBXFalsehM}r}((hO]hP]hQ]hR]hU]uhCjw(hY]r~(hbXFalser(…r€(}r((hBXFalsehINhWNhXhhCj{(ubahKhyubahKjŻubehKjŽubaubhu)r‚(}rƒ((hBX¶Link executables dynamically. The executable's library dependencies should be built as shared objects. This implies ``shared: True`` unless ``shared: False`` is explicitly specified.hCjd(hIhJhKhyhM}r„((hO]hP]hQ]hR]hU]uhWM˜hXhhY]r…((hbXvLink executables dynamically. The executableā€™s library dependencies should be built as shared objects. This implies r†(…r‡(}rˆ((hBXtLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies hINhWNhXhhCj‚(ubh›)r‰(}rŠ((hBX``shared: True``hM}r‹((hO]hP]hQ]hR]hU]uhCj‚(hY]rŒ(hbX shared: Truer(…rŽ(}r((hBUhCj‰(ubahKh£ubhbX unless r(…r‘(}r’((hBX unless hINhWNhXhhCj‚(ubh›)r“(}r”((hBX``shared: False``hM}r•((hO]hP]hQ]hR]hU]uhCj‚(hY]r–(hbX shared: Falser—(…r˜(}r™((hBUhCj“(ubahKh£ubhbX is explicitly specified.rš(…r›(}rœ((hBX is explicitly specified.hINhWNhXhhCj‚(ubeubhu)r(}rž((hBXnThe command line variant of this flag is ``--enable-executable-dynamic`` and ``--disable-executable-dynamic``.hCjd(hIhJhKhyhM}rŸ((hO]hP]hQ]hR]hU]uhWMœhXhhY]r ((hbX)The command line variant of this flag is r”(…r¢(}r£((hBX)The command line variant of this flag is hINhWNhXhhCj(ubh›)r¤(}r„((hBX``--enable-executable-dynamic``hM}r¦((hO]hP]hQ]hR]hU]uhCj(hY]r§(hbX--enable-executable-dynamicrØ(…r©(}rŖ((hBUhCj¤(ubahKh£ubhbX and r«(…r¬(}r­((hBX and hINhWNhXhhCj(ubh›)r®(}rÆ((hBX ``--disable-executable-dynamic``hM}r°((hO]hP]hQ]hR]hU]uhCj(hY]r±(hbX--disable-executable-dynamicr²(…r³(}r“((hBUhCj®(ubahKh£ubhbX.…rµ(}r¶((hBX.hINhWNhXhhCj(ubeubeubeubjw)r·(}rø((hBUhCj`'hIhJhKjzhM}r¹((hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rŗ(}r»((hBUhCj`'hIhJhKjhM}r¼((j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr½(j…j½(uhWNhXhhY]r¾((j‡)ræ(}rĄ((hBXlibrary-for-ghci: booleanhCjŗ(hIhJhKjŠhM}rĮ((hR]rĀ(Xcfg-field-library-for-ghcirĆ(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rÄ((jw)rÅ(}rĘ((hBUhCjæ(hIhJhKjzhM}rĒ((hR]hQ]hO]hP]hU]Uentries]rČ((j”X'library-for-ghci ; cabal project optionjĆ(UNtrÉ(auhWNhXhhY]ubj–)rŹ(}rĖ((hBXlibrary-for-ghcirĢ(hCjæ(hIhJhKjšhM}rĶ((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĪ(hbXlibrary-for-ghcirĻ(…rŠ(}rŃ((hBUhINhWNhXhhCjŹ(ubaubj )rŅ(}rÓ((hBj£hCjæ(hIhJhKj¤hM}rŌ((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÕ(hbX: rÖ(…r×(}rŲ((hBUhINhWNhXhhCjŅ(ubaubjŖ)rŁ(}rŚ((hBXbooleanhCjæ(hIhJhKj­hM}rŪ((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÜ(hbXbooleanrŻ(…rŽ(}rß((hBUhINhWNhXhhCjŁ(ubaubeubj‡)rą(}rį((hBX--enable-library-for-ghcirā(hCjŗ(hIhJhKjŠhM}rć((hR]rä(X"cfg-flag---enable-library-for-ghcirå(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rę((jw)rē(}rč((hBUhCją(hIhJhKjzhM}ré((hR]hQ]hO]hP]hU]Uentries]rź((j”X/--enable-library-for-ghci; cabal project optionjå(UNtrė(auhWNhXhhY]ubj–)rģ(}rķ((hBjā(hCją(hIhJhKjšhM}rī((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rļ(hbX--enable-library-for-ghcirš(…rń(}rņ((hBUhINhWNhXhhCjģ(ubaubj )ró(}rō((hBU hCją(hIhJhKj¤hM}rõ((jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rö(hbX …r÷(}rų((hBUhINhWNhXhhCjó(ubaubeubj‡)rł(}rś((hBX--disable-library-for-ghcirū(hCjŗ(hIhJhKjŠhM}rü((hR]rż(X#cfg-flag---disable-library-for-ghcirž(ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r’((jw)r)}r)(hBUhCjł(hIhJhKjzhM}r)(hR]hQ]hO]hP]hU]Uentries]r)(j”X0--disable-library-for-ghci; cabal project optionjž(UNtr)auhWNhXhhY]ubj–)r)}r)(hBjū(hCjł(hIhJhKjšhM}r)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r)hbX--disable-library-for-ghcir )…r )}r )(hBUhINhWNhXhhCj)ubaubj )r )}r )(hBU hCjł(hIhJhKj¤hM}r)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r)hbX …r)}r)(hBUhINhWNhXhhCj )ubaubeubj³)r)}r)(hBUhCjŗ(hIhJhKj¶hM}r)(hO]hP]hQ]hR]hU]uhWNhXhhY]r)(j¹)r)}r)(hBUhCj)hIhJhKj¼hM}r)(hO]hP]hQ]hR]hU]uhWNhXhhY]r)jæ)r)}r)(hBUhM}r)(hO]hP]hQ]hR]hU]uhCj)hY]r)(jÄ)r)}r)(hBX Default valuehCj)hIhJhKjĒhM}r )(hO]hP]hQ]hR]hU]uhWKhY]r!)hbX Default valuer")…r#)}r$)(hBUhCj)ubaubjĶ)r%)}r&)(hBUhM}r')(hO]hP]hQ]hR]hU]uhCj)hY]r()hu)r))}r*)(hBXTruehM}r+)(hO]hP]hQ]hR]hU]uhCj%)hY]r,)hbXTruer-)…r.)}r/)(hBXTruehINhWNhXhhCj))ubahKhyubahKjŻubehKjŽubaubhu)r0)}r1)(hBX`Build libraries suitable for use with GHCi. This involves an extra linking step after the build.r2)hCj)hIhJhKhyhM}r3)(hO]hP]hQ]hR]hU]uhWM§hXhhY]r4)hbX`Build libraries suitable for use with GHCi. This involves an extra linking step after the build.r5)…r6)}r7)(hBj2)hINhWNhXhhCj0)ubaubhu)r8)}r9)(hBXš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``.hCj)hIhJhKhyhM}r:)(hO]hP]hQ]hR]hU]uhWMŖhXhhY]r;)(hbX~Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases, consider setting r<)…r=)}r>)(hBX~Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases, consider setting hINhWNhXhhCj8)ubh›)r?)}r@)(hBX``library-for-ghci: False``hM}rA)(hO]hP]hQ]hR]hU]uhCj8)hY]rB)hbXlibrary-for-ghci: FalserC)…rD)}rE)(hBUhCj?)ubahKh£ubhbX.…rF)}rG)(hBX.hINhWNhXhhCj8)ubeubhu)rH)}rI)(hBXjThe command line variant of this flag is ``--enable-library-for-ghci`` and ``--disable-library-for-ghci``.hCj)hIhJhKhyhM}rJ)(hO]hP]hQ]hR]hU]uhWM®hXhhY]rK)(hbX)The command line variant of this flag is rL)…rM)}rN)(hBX)The command line variant of this flag is hINhWNhXhhCjH)ubh›)rO)}rP)(hBX``--enable-library-for-ghci``hM}rQ)(hO]hP]hQ]hR]hU]uhCjH)hY]rR)hbX--enable-library-for-ghcirS)…rT)}rU)(hBUhCjO)ubahKh£ubhbX and rV)…rW)}rX)(hBX and hINhWNhXhhCjH)ubh›)rY)}rZ)(hBX``--disable-library-for-ghci``hM}r[)(hO]hP]hQ]hR]hU]uhCjH)hY]r\)hbX--disable-library-for-ghcir])…r^)}r_)(hBUhCjY)ubahKh£ubhbX.…r`)}ra)(hBX.hINhWNhXhhCjH)ubeubeubeubjw)rb)}rc)(hBUhCj`'hIhJhKjzhM}rd)(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)re)}rf)(hBUhCj`'hIhJhKjhM}rg)(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrh)j…jh)uhWNhXhhY]ri)(j‡)rj)}rk)(hBX relocatable:hCje)hIhJhKjŠhM}rl)(hR]rm)Xcfg-field-relocatablern)ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]ro)(jw)rp)}rq)(hBUhCjj)hIhJhKjzhM}rr)(hR]hQ]hO]hP]hU]Uentries]rs)(j”X"relocatable ; cabal project optionjn)UNtrt)auhWNhXhhY]ubj–)ru)}rv)(hBX relocatablerw)hCjj)hIhJhKjšhM}rx)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ry)hbX relocatablerz)…r{)}r|)(hBUhINhWNhXhhCju)ubaubj )r})}r~)(hBj£hCjj)hIhJhKj¤hM}r)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r€)hbX: r)…r‚)}rƒ)(hBUhINhWNhXhhCj})ubaubjŖ)r„)}r…)(hBUhCjj)hIhJhKj­hM}r†)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ubeubj‡)r‡)}rˆ)(hBX --relocatabler‰)hCje)hIhJhKjŠhM}rŠ)(hR]r‹)Xcfg-flag---relocatablerŒ)ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r)(jw)rŽ)}r)(hBUhCj‡)hIhJhKjzhM}r)(hR]hQ]hO]hP]hU]Uentries]r‘)(j”X#--relocatable; cabal project optionjŒ)UNtr’)auhWNhXhhY]ubj–)r“)}r”)(hBj‰)hCj‡)hIhJhKjšhM}r•)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r–)hbX --relocatabler—)…r˜)}r™)(hBUhINhWNhXhhCj“)ubaubj )rš)}r›)(hBU hCj‡)hIhJhKj¤hM}rœ)(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r)hbX …rž)}rŸ)(hBUhINhWNhXhhCjš)ubaubeubj³)r )}r”)(hBUhCje)hIhJhKj¶hM}r¢)(hO]hP]hQ]hR]hU]uhWNhXhhY]r£)(j¹)r¤)}r„)(hBUhCj )hIhJhKj¼hM}r¦)(hO]hP]hQ]hR]hU]uhWNhXhhY]r§)(jæ)rØ)}r©)(hBUhCj¤)hIhJhKjŽhM}rŖ)(hO]hP]hQ]hR]hU]uhWNhXhhY]r«)(jÄ)r¬)}r­)(hBjæhCjØ)hIhJhKjĒhM}r®)(hO]hP]hQ]hR]hU]uhWKhY]rÆ)hbXSincer°)…r±)}r²)(hBUhCj¬)ubaubjĶ)r³)}r“)(hBU Cabal 1.21rµ)hM}r¶)(hO]hP]hQ]hR]hU]uhCjØ)hY]r·)hu)rø)}r¹)(hBjµ)hM}rŗ)(hO]hP]hQ]hR]hU]uhCj³)hY]r»)hbX Cabal 1.21r¼)…r½)}r¾)(hBUhCjø)ubahKhyubahKjŻubeubjæ)ræ)}rĄ)(hBUhM}rĮ)(hO]hP]hQ]hR]hU]uhCj¤)hY]rĀ)(jÄ)rĆ)}rÄ)(hBX Default valuehCjæ)hIhJhKjĒhM}rÅ)(hO]hP]hQ]hR]hU]uhWKhY]rĘ)hbX Default valuerĒ)…rČ)}rÉ)(hBUhCjĆ)ubaubjĶ)rŹ)}rĖ)(hBUhM}rĢ)(hO]hP]hQ]hR]hU]uhCjæ)hY]rĶ)hu)rĪ)}rĻ)(hBXFalsehM}rŠ)(hO]hP]hQ]hR]hU]uhCjŹ)hY]rŃ)hbXFalserŅ)…rÓ)}rŌ)(hBXFalsehINhWNhXhhCjĪ)ubahKhyubahKjŻubehKjŽubeubhu)rÕ)}rÖ)(hBXy[STRIKEOUT:Build a package which is relocatable.] (TODO: It is not clear what this actually does, or if it works at all.)r×)hCj )hIhJhKhyhM}rŲ)(hO]hP]hQ]hR]hU]uhWMøhXhhY]rŁ)hbXy[STRIKEOUT:Build a package which is relocatable.] (TODO: It is not clear what this actually does, or if it works at all.)rŚ)…rŪ)}rÜ)(hBj×)hINhWNhXhhCjÕ)ubaubhu)rŻ)}rŽ)(hBX;The command line variant of this flag is ``--relocatable``.hCj )hIhJhKhyhM}rß)(hO]hP]hQ]hR]hU]uhWM»hXhhY]rą)(hbX)The command line variant of this flag is rį)…rā)}rć)(hBX)The command line variant of this flag is hINhWNhXhhCjŻ)ubh›)rä)}rå)(hBX``--relocatable``hM}rę)(hO]hP]hQ]hR]hU]uhCjŻ)hY]rē)hbX --relocatablerč)…ré)}rź)(hBUhCjä)ubahKh£ubhbX.…rė)}rģ)(hBX.hINhWNhXhhCjŻ)ubeubeubeubeubhD)rķ)}rī)(hBUhCj™hIhJhKhLhM}rļ)(hO]hP]hQ]hR]rš)jÖ ahU]rń)h auhWM¾hXhhY]rņ)(h[)ró)}rō)(hBXStatic linking optionsrõ)hCjķ)hIhJhKh_hM}rö)(hO]hP]hQ]hR]hU]uhWM¾hXhhY]r÷)hbXStatic linking optionsrų)…rł)}rś)(hBjõ)hINhWNhXhhCjó)ubaubjw)rū)}rü)(hBUhCjķ)hIhJhKjzhM}rż)(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rž)}r’)(hBUhCjķ)hIhJhKjhM}r*(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr*j…j*uhWNhXhhY]r*(j‡)r*}r*(hBXstatic: booleanhCjž)hIhJhKjŠhM}r*(hR]r*Xcfg-field-staticr*ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r*(jw)r *}r *(hBUhCj*hIhJhKjzhM}r *(hR]hQ]hO]hP]hU]Uentries]r *(j”Xstatic ; cabal project optionj*UNtr *auhWNhXhhY]ubj–)r*}r*(hBXstaticr*hCj*hIhJhKjšhM}r*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r*hbXstaticr*…r*}r*(hBUhINhWNhXhhCj*ubaubj )r*}r*(hBj£hCj*hIhJhKj¤hM}r*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r*hbX: r*…r*}r*(hBUhINhWNhXhhCj*ubaubjŖ)r*}r*(hBXbooleanhCj*hIhJhKj­hM}r*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r *hbXbooleanr!*…r"*}r#*(hBUhINhWNhXhhCj*ubaubeubj‡)r$*}r%*(hBX--enable-staticr&*hCjž)hIhJhKjŠhM}r'*(hR]r(*Xcfg-flag---enable-staticr)*ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r**(jw)r+*}r,*(hBUhCj$*hIhJhKjzhM}r-*(hR]hQ]hO]hP]hU]Uentries]r.*(j”X%--enable-static; cabal project optionj)*UNtr/*auhWNhXhhY]ubj–)r0*}r1*(hBj&*hCj$*hIhJhKjšhM}r2*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r3*hbX--enable-staticr4*…r5*}r6*(hBUhINhWNhXhhCj0*ubaubj )r7*}r8*(hBU hCj$*hIhJhKj¤hM}r9*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r:*hbX …r;*}r<*(hBUhINhWNhXhhCj7*ubaubeubj‡)r=*}r>*(hBX--disable-staticr?*hCjž)hIhJhKjŠhM}r@*(hR]rA*Xcfg-flag---disable-staticrB*ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rC*(jw)rD*}rE*(hBUhCj=*hIhJhKjzhM}rF*(hR]hQ]hO]hP]hU]Uentries]rG*(j”X&--disable-static; cabal project optionjB*UNtrH*auhWNhXhhY]ubj–)rI*}rJ*(hBj?*hCj=*hIhJhKjšhM}rK*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rL*hbX--disable-staticrM*…rN*}rO*(hBUhINhWNhXhhCjI*ubaubj )rP*}rQ*(hBU hCj=*hIhJhKj¤hM}rR*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rS*hbX …rT*}rU*(hBUhINhWNhXhhCjP*ubaubeubj³)rV*}rW*(hBUhCjž)hIhJhKj¶hM}rX*(hO]hP]hQ]hR]hU]uhWNhXhhY]rY*(j¹)rZ*}r[*(hBUhCjV*hIhJhKj¼hM}r\*(hO]hP]hQ]hR]hU]uhWNhXhhY]r]*jæ)r^*}r_*(hBUhM}r`*(hO]hP]hQ]hR]hU]uhCjZ*hY]ra*(jÄ)rb*}rc*(hBX Default valuehCj^*hIhJhKjĒhM}rd*(hO]hP]hQ]hR]hU]uhWKhY]re*hbX Default valuerf*…rg*}rh*(hBUhCjb*ubaubjĶ)ri*}rj*(hBUhM}rk*(hO]hP]hQ]hR]hU]uhCj^*hY]rl*hu)rm*}rn*(hBXFalsehM}ro*(hO]hP]hQ]hR]hU]uhCji*hY]rp*hbXFalserq*…rr*}rs*(hBXFalsehINhWNhXhhCjm*ubahKhyubahKjŻubehKjŽubaubhu)rt*}ru*(hBX»Roll this and all dependent libraries into a combined ``.a`` archive. This uses GHCs ``-staticlib`` flag, which is avaiable for iOS and with GHC 8.4 and later for other platforms as well.hCjV*hIhJhKhyhM}rv*(hO]hP]hQ]hR]hU]uhWMČhXhhY]rw*(hbX6Roll this and all dependent libraries into a combined rx*…ry*}rz*(hBX6Roll this and all dependent libraries into a combined hINhWNhXhhCjt*ubh›)r{*}r|*(hBX``.a``hM}r}*(hO]hP]hQ]hR]hU]uhCjt*hY]r~*hbX.ar*…r€*}r*(hBUhCj{*ubahKh£ubhbX archive. This uses GHCs r‚*…rƒ*}r„*(hBX archive. This uses GHCs hINhWNhXhhCjt*ubh›)r…*}r†*(hBX``-staticlib``hM}r‡*(hO]hP]hQ]hR]hU]uhCjt*hY]rˆ*hbX -staticlibr‰*…rŠ*}r‹*(hBUhCj…*ubahKh£ubhbXX flag, which is avaiable for iOS and with GHC 8.4 and later for other platforms as well.rŒ*…r*}rŽ*(hBXX flag, which is avaiable for iOS and with GHC 8.4 and later for other platforms as well.hINhWNhXhhCjt*ubeubeubeubeubhD)r*}r*(hBUhCj™hIhJhKhLhM}r‘*(hO]hP]hQ]hR]r’*jå ahU]r“*h#auhWMĶhXhhY]r”*(h[)r•*}r–*(hBX"Foreign function interface optionsr—*hCj*hIhJhKh_hM}r˜*(hO]hP]hQ]hR]hU]uhWMĶhXhhY]r™*hbX"Foreign function interface optionsrš*…r›*}rœ*(hBj—*hINhWNhXhhCj•*ubaubjw)r*}rž*(hBUhCj*hIhJhKjzhM}rŸ*(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r *}r”*(hBUhCj*hIhJhKjhM}r¢*(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr£*j…j£*uhWNhXhhY]r¤*(j‡)r„*}r¦*(hBXAextra-include-dirs: directories (comma or newline separated list)hCj *hIhJhKjŠhM}r§*(hR]rØ*Xcfg-field-extra-include-dirsr©*ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŖ*(jw)r«*}r¬*(hBUhCj„*hIhJhKjzhM}r­*(hR]hQ]hO]hP]hU]Uentries]r®*(j”X)extra-include-dirs ; cabal project optionj©*UNtrÆ*auhWNhXhhY]ubj–)r°*}r±*(hBXextra-include-dirsr²*hCj„*hIhJhKjšhM}r³*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“*hbXextra-include-dirsrµ*…r¶*}r·*(hBUhINhWNhXhhCj°*ubaubj )rø*}r¹*(hBj£hCj„*hIhJhKj¤hM}rŗ*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r»*hbX: r¼*…r½*}r¾*(hBUhINhWNhXhhCjø*ubaubjŖ)ræ*}rĄ*(hBX-directories (comma or newline separated list)hCj„*hIhJhKj­hM}rĮ*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĀ*hbX-directories (comma or newline separated list)rĆ*…rÄ*}rÅ*(hBUhINhWNhXhhCjæ*ubaubeubj‡)rĘ*}rĒ*(hBX--extra-include-dirs=DIRhCj *hIhJhKjŠhM}rČ*(hR]rÉ*Xcfg-flag---extra-include-dirsrŹ*ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĖ*(jw)rĢ*}rĶ*(hBUhCjĘ*hIhJhKjzhM}rĪ*(hR]hQ]hO]hP]hU]Uentries]rĻ*(j”X*--extra-include-dirs; cabal project optionjŹ*UNtrŠ*auhWNhXhhY]ubj–)rŃ*}rŅ*(hBX--extra-include-dirsrÓ*hCjĘ*hIhJhKjšhM}rŌ*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÕ*hbX--extra-include-dirsrÖ*…r×*}rŲ*(hBUhINhWNhXhhCjŃ*ubaubj )rŁ*}rŚ*(hBX=DIRhCjĘ*hIhJhKj¤hM}rŪ*(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÜ*hbX=DIRrŻ*…rŽ*}rß*(hBUhINhWNhXhhCjŁ*ubaubeubj³)rą*}rį*(hBUhCj *hIhJhKj¶hM}rā*(hO]hP]hQ]hR]hU]uhWNhXhhY]rć*(hu)rä*}rå*(hBXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rę*hCją*hIhJhKhyhM}rē*(hO]hP]hQ]hR]hU]uhWMÓhXhhY]rč*hbXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.ré*…rź*}rė*(hBję*hINhWNhXhhCjä*ubaubhu)rģ*}rķ*(hBXYYou 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.hCją*hIhJhKhyhM}rī*(hO]hP]hQ]hR]hU]uhWMÖhXhhY]rļ*(hbX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 rš*…rń*}rņ*(hBX‹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 hINhWNhXhhCjģ*ubh›)ró*}rō*(hBX ``.cabal``hM}rõ*(hO]hP]hQ]hR]hU]uhCjģ*hY]rö*hbX.cabalr÷*…rų*}rł*(hBUhCjó*ubahKh£ubhbXH file. Using this option has the same affect as appending the directory rś*…rū*}rü*(hBXH file. Using this option has the same affect as appending the directory hINhWNhXhhCjģ*ubjŖ)rż*}rž*(hBX*dir*hM}r’*(hO]hP]hQ]hR]hU]uhCjģ*hY]r+hbXdirr+…r+}r+(hBUhCjż*ubahKj²ubhbX to the r+…r+}r+(hBX to the hINhWNhXhhCjģ*ubj[)r+}r+(hBX:pkg-field:`include-dirs`r +hCjģ*hIhJhKj_hM}r +(UreftypeX pkg-fieldjaˆjbX include-dirsU refdomainXcabalr +hR]hQ]U refexplicit‰hO]hP]hU]jdjejņNuhWMÖhY]r +h›)r +}r+(hBj +hM}r+(hO]hP]r+(jlj +Xcabal-pkg-fieldr+ehQ]hR]hU]uhCj+hY]r+hbX include-dirsr+…r+}r+(hBUhCj +ubahKh£ubaubhbX9 field in each library and executable in the packageā€™s r+…r+}r+(hBX7 field in each library and executable in the package's hINhWNhXhhCjģ*ubh›)r+}r+(hBX ``.cabal``hM}r+(hO]hP]hQ]hR]hU]uhCjģ*hY]r+hbX.cabalr+…r+}r+(hBUhCj+ubahKh£ubhbX 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 +…r!+}r"+(hBX 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.hINhWNhXhhCjģ*ubeubhu)r#+}r$+(hBXmThe command line variant of this flag is ``--extra-include-dirs=DIR``, which can be specified multiple times.hCją*hIhJhKhyhM}r%+(hO]hP]hQ]hR]hU]uhWMąhXhhY]r&+(hbX)The command line variant of this flag is r'+…r(+}r)+(hBX)The command line variant of this flag is hINhWNhXhhCj#+ubh›)r*+}r++(hBX``--extra-include-dirs=DIR``hM}r,+(hO]hP]hQ]hR]hU]uhCj#+hY]r-+hbX--extra-include-dirs=DIRr.+…r/+}r0+(hBUhCj*+ubahKh£ubhbX(, which can be specified multiple times.r1+…r2+}r3+(hBX(, which can be specified multiple times.hINhWNhXhhCj#+ubeubeubeubjw)r4+}r5+(hBUhCj*hIhJhKjzhM}r6+(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r7+}r8+(hBUhCj*hIhJhKjhM}r9+(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr:+j…j:+uhWNhXhhY]r;+(j‡)r<+}r=+(hBX=extra-lib-dirs: directories (comma or newline separated list)hCj7+hIhJhKjŠhM}r>+(hR]r?+Xcfg-field-extra-lib-dirsr@+ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rA+(jw)rB+}rC+(hBUhCj<+hIhJhKjzhM}rD+(hR]hQ]hO]hP]hU]Uentries]rE+(j”X%extra-lib-dirs ; cabal project optionj@+UNtrF+auhWNhXhhY]ubj–)rG+}rH+(hBXextra-lib-dirsrI+hCj<+hIhJhKjšhM}rJ+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rK+hbXextra-lib-dirsrL+…rM+}rN+(hBUhINhWNhXhhCjG+ubaubj )rO+}rP+(hBj£hCj<+hIhJhKj¤hM}rQ+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rR+hbX: rS+…rT+}rU+(hBUhINhWNhXhhCjO+ubaubjŖ)rV+}rW+(hBX-directories (comma or newline separated list)hCj<+hIhJhKj­hM}rX+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rY+hbX-directories (comma or newline separated list)rZ+…r[+}r\+(hBUhINhWNhXhhCjV+ubaubeubj‡)r]+}r^+(hBX--extra-lib-dirs=DIRhCj7+hIhJhKjŠhM}r_+(hR]r`+Xcfg-flag---extra-lib-dirsra+ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rb+(jw)rc+}rd+(hBUhCj]+hIhJhKjzhM}re+(hR]hQ]hO]hP]hU]Uentries]rf+(j”X&--extra-lib-dirs; cabal project optionja+UNtrg+auhWNhXhhY]ubj–)rh+}ri+(hBX--extra-lib-dirsrj+hCj]+hIhJhKjšhM}rk+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rl+hbX--extra-lib-dirsrm+…rn+}ro+(hBUhINhWNhXhhCjh+ubaubj )rp+}rq+(hBX=DIRhCj]+hIhJhKj¤hM}rr+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rs+hbX=DIRrt+…ru+}rv+(hBUhINhWNhXhhCjp+ubaubeubj³)rw+}rx+(hBUhCj7+hIhJhKj¶hM}ry+(hO]hP]hQ]hR]hU]uhWNhXhhY]rz+(hu)r{+}r|+(hBX8An extra directory to search for system libraries files.r}+hCjw+hIhJhKhyhM}r~+(hO]hP]hQ]hR]hU]uhWMēhXhhY]r+hbX8An extra directory to search for system libraries files.r€+…r+}r‚+(hBj}+hINhWNhXhhCj{+ubaubhu)rƒ+}r„+(hBXiThe command line variant of this flag is ``--extra-lib-dirs=DIR``, which can be specified multiple times.hCjw+hIhJhKhyhM}r…+(hO]hP]hQ]hR]hU]uhWMéhXhhY]r†+(hbX)The command line variant of this flag is r‡+…rˆ+}r‰+(hBX)The command line variant of this flag is hINhWNhXhhCjƒ+ubh›)rŠ+}r‹+(hBX``--extra-lib-dirs=DIR``hM}rŒ+(hO]hP]hQ]hR]hU]uhCjƒ+hY]r+hbX--extra-lib-dirs=DIRrŽ+…r+}r+(hBUhCjŠ+ubahKh£ubhbX(, which can be specified multiple times.r‘+…r’+}r“+(hBX(, which can be specified multiple times.hINhWNhXhhCjƒ+ubeubeubeubjw)r”+}r•+(hBUhCj*hIhJhKjzhM}r–+(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r—+}r˜+(hBUhCj*hIhJhKjhM}r™+(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrš+j…jš+uhWNhXhhY]r›+(j‡)rœ+}r+(hBXCextra-framework-dirs: directories (comma or newline separated list)hCj—+hIhJhKjŠhM}rž+(hR]rŸ+Xcfg-field-extra-framework-dirsr +ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r”+(jw)r¢+}r£+(hBUhCjœ+hIhJhKjzhM}r¤+(hR]hQ]hO]hP]hU]Uentries]r„+(j”X+extra-framework-dirs ; cabal project optionj +UNtr¦+auhWNhXhhY]ubj–)r§+}rØ+(hBXextra-framework-dirsr©+hCjœ+hIhJhKjšhM}rŖ+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r«+hbXextra-framework-dirsr¬+…r­+}r®+(hBUhINhWNhXhhCj§+ubaubj )rÆ+}r°+(hBj£hCjœ+hIhJhKj¤hM}r±+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r²+hbX: r³+…r“+}rµ+(hBUhINhWNhXhhCjÆ+ubaubjŖ)r¶+}r·+(hBX-directories (comma or newline separated list)hCjœ+hIhJhKj­hM}rø+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¹+hbX-directories (comma or newline separated list)rŗ+…r»+}r¼+(hBUhINhWNhXhhCj¶+ubaubeubj‡)r½+}r¾+(hBX--extra-framework-dirs=DIRhCj—+hIhJhKjŠhM}ræ+(hR]rĄ+Xcfg-flag---extra-framework-dirsrĮ+ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĀ+(jw)rĆ+}rÄ+(hBUhCj½+hIhJhKjzhM}rÅ+(hR]hQ]hO]hP]hU]Uentries]rĘ+(j”X,--extra-framework-dirs; cabal project optionjĮ+UNtrĒ+auhWNhXhhY]ubj–)rČ+}rÉ+(hBX--extra-framework-dirsrŹ+hCj½+hIhJhKjšhM}rĖ+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĢ+hbX--extra-framework-dirsrĶ+…rĪ+}rĻ+(hBUhINhWNhXhhCjČ+ubaubj )rŠ+}rŃ+(hBX=DIRhCj½+hIhJhKj¤hM}rŅ+(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÓ+hbX=DIRrŌ+…rÕ+}rÖ+(hBUhINhWNhXhhCjŠ+ubaubeubj³)r×+}rŲ+(hBUhCj—+hIhJhKj¶hM}rŁ+(hO]hP]hQ]hR]hU]uhWNhXhhY]rŚ+(hu)rŪ+}rÜ+(hBX8An extra directory to search for frameworks (OS X only).rŻ+hCj×+hIhJhKhyhM}rŽ+(hO]hP]hQ]hR]hU]uhWMšhXhhY]rß+hbX8An extra directory to search for frameworks (OS X only).rą+…rį+}rā+(hBjŻ+hINhWNhXhhCjŪ+ubaubhu)rć+}rä+(hBXXYou 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.hCj×+hIhJhKhyhM}rå+(hO]hP]hQ]hR]hU]uhWMņhXhhY]rę+(hbXŠ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ē+…rč+}ré+(hBXˆ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 hINhWNhXhhCjć+ubh›)rź+}rė+(hBX ``.cabal``hM}rģ+(hO]hP]hQ]hR]hU]uhCjć+hY]rķ+hbX.cabalrī+…rļ+}rš+(hBUhCjź+ubahKh£ubhbXH file. Using this option has the same affect as appending the directory rń+…rņ+}ró+(hBXH file. Using this option has the same affect as appending the directory hINhWNhXhhCjć+ubjŖ)rō+}rõ+(hBX*dir*hM}rö+(hO]hP]hQ]hR]hU]uhCjć+hY]r÷+hbXdirrų+…rł+}rś+(hBUhCjō+ubahKj²ubhbX to the rū+…rü+}rż+(hBX to the hINhWNhXhhCjć+ubj[)rž+}r’+(hBX:cfg-field:`extra-lib-dirs`r,hCjć+hIhJhKj_hM}r,(UreftypeX cfg-fieldjaˆjbXextra-lib-dirsU refdomainXcabalr,hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMņhY]r,h›)r,}r,(hBj,hM}r,(hO]hP]r,(jlj,Xcabal-cfg-fieldr,ehQ]hR]hU]uhCjž+hY]r ,hbXextra-lib-dirsr ,…r ,}r ,(hBUhCj,ubahKh£ubaubhbX9 field in each library and executable in the packageā€™s r ,…r,}r,(hBX7 field in each library and executable in the package's hINhWNhXhhCjć+ubh›)r,}r,(hBX ``.cabal``hM}r,(hO]hP]hQ]hR]hU]uhCjć+hY]r,hbX.cabalr,…r,}r,(hBUhCj,ubahKh£ubhbX 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,…r,}r,(hBX 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.hINhWNhXhhCjć+ubeubhu)r,}r,(hBXoThe command line variant of this flag is ``--extra-framework-dirs=DIR``, which can be specified multiple times.hCj×+hIhJhKhyhM}r,(hO]hP]hQ]hR]hU]uhWMühXhhY]r,(hbX)The command line variant of this flag is r,…r,}r ,(hBX)The command line variant of this flag is hINhWNhXhhCj,ubh›)r!,}r",(hBX``--extra-framework-dirs=DIR``hM}r#,(hO]hP]hQ]hR]hU]uhCj,hY]r$,hbX--extra-framework-dirs=DIRr%,…r&,}r',(hBUhCj!,ubahKh£ubhbX(, which can be specified multiple times.r(,…r),}r*,(hBX(, which can be specified multiple times.hINhWNhXhhCj,ubeubeubeubeubhD)r+,}r,,(hBUhCj™hIhJhKhLhM}r-,(hO]hP]hQ]hR]r.,jń ahU]r/,h:auhWMhXhhY]r0,(h[)r1,}r2,(hBXProfiling optionsr3,hCj+,hIhJhKh_hM}r4,(hO]hP]hQ]hR]hU]uhWMhXhhY]r5,hbXProfiling optionsr6,…r7,}r8,(hBj3,hINhWNhXhhCj1,ubaubjw)r9,}r:,(hBUhCj+,hIhJhKjzhM}r;,(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r<,}r=,(hBUhCj+,hIhJhKjhM}r>,(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr?,j…j?,uhWNhXhhY]r@,(j‡)rA,}rB,(hBXprofiling: booleanhCj<,hIhJhKjŠhM}rC,(hR]rD,Xcfg-field-profilingrE,ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rF,(jw)rG,}rH,(hBUhCjA,hIhJhKjzhM}rI,(hR]hQ]hO]hP]hU]Uentries]rJ,(j”X profiling ; cabal project optionjE,UNtrK,auhWNhXhhY]ubj–)rL,}rM,(hBX profilingrN,hCjA,hIhJhKjšhM}rO,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rP,hbX profilingrQ,…rR,}rS,(hBUhINhWNhXhhCjL,ubaubj )rT,}rU,(hBj£hCjA,hIhJhKj¤hM}rV,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rW,hbX: rX,…rY,}rZ,(hBUhINhWNhXhhCjT,ubaubjŖ)r[,}r\,(hBXbooleanhCjA,hIhJhKj­hM}r],(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r^,hbXbooleanr_,…r`,}ra,(hBUhINhWNhXhhCj[,ubaubeubj‡)rb,}rc,(hBX--enable-profilingrd,hCj<,hIhJhKjŠhM}re,(hR]rf,Xcfg-flag---enable-profilingrg,ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rh,(jw)ri,}rj,(hBUhCjb,hIhJhKjzhM}rk,(hR]hQ]hO]hP]hU]Uentries]rl,(j”X(--enable-profiling; cabal project optionjg,UNtrm,auhWNhXhhY]ubj–)rn,}ro,(hBjd,hCjb,hIhJhKjšhM}rp,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rq,hbX--enable-profilingrr,…rs,}rt,(hBUhINhWNhXhhCjn,ubaubj )ru,}rv,(hBU hCjb,hIhJhKj¤hM}rw,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rx,hbX …ry,}rz,(hBUhINhWNhXhhCju,ubaubeubj‡)r{,}r|,(hBX--disable-profilingr},hCj<,hIhJhKjŠhM}r~,(hR]r,Xcfg-flag---disable-profilingr€,ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r,(jw)r‚,}rƒ,(hBUhCj{,hIhJhKjzhM}r„,(hR]hQ]hO]hP]hU]Uentries]r…,(j”X)--disable-profiling; cabal project optionj€,UNtr†,auhWNhXhhY]ubj–)r‡,}rˆ,(hBj},hCj{,hIhJhKjšhM}r‰,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠ,hbX--disable-profilingr‹,…rŒ,}r,(hBUhINhWNhXhhCj‡,ubaubj )rŽ,}r,(hBU hCj{,hIhJhKj¤hM}r,(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‘,hbX …r’,}r“,(hBUhINhWNhXhhCjŽ,ubaubeubj³)r”,}r•,(hBUhCj<,hIhJhKj¶hM}r–,(hO]hP]hQ]hR]hU]uhWNhXhhY]r—,(j¹)r˜,}r™,(hBUhCj”,hIhJhKj¼hM}rš,(hO]hP]hQ]hR]hU]uhWNhXhhY]r›,(jæ)rœ,}r,(hBUhCj˜,hIhJhKjŽhM}rž,(hO]hP]hQ]hR]hU]uhWNhXhhY]rŸ,(jÄ)r ,}r”,(hBjæhCjœ,hIhJhKjĒhM}r¢,(hO]hP]hQ]hR]hU]uhWKhY]r£,hbXSincer¤,…r„,}r¦,(hBUhCj ,ubaubjĶ)r§,}rØ,(hBU Cabal 1.21r©,hM}rŖ,(hO]hP]hQ]hR]hU]uhCjœ,hY]r«,hu)r¬,}r­,(hBj©,hM}r®,(hO]hP]hQ]hR]hU]uhCj§,hY]rÆ,hbX Cabal 1.21r°,…r±,}r²,(hBUhCj¬,ubahKhyubahKjŻubeubjæ)r³,}r“,(hBUhM}rµ,(hO]hP]hQ]hR]hU]uhCj˜,hY]r¶,(jÄ)r·,}rø,(hBX Default valuehCj³,hIhJhKjĒhM}r¹,(hO]hP]hQ]hR]hU]uhWKhY]rŗ,hbX Default valuer»,…r¼,}r½,(hBUhCj·,ubaubjĶ)r¾,}ræ,(hBUhM}rĄ,(hO]hP]hQ]hR]hU]uhCj³,hY]rĮ,hu)rĀ,}rĆ,(hBXFalsehM}rÄ,(hO]hP]hQ]hR]hU]uhCj¾,hY]rÅ,hbXFalserĘ,…rĒ,}rČ,(hBXFalsehINhWNhXhhCjĀ,ubahKhyubahKjŻubehKjŽubeubhu)rÉ,}rŹ,(hBX@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 new-build`` will ensure that all of its transitive dependencies are built with profiling enabled.hCj”,hIhJhKhyhM}rĖ,(hO]hP]hQ]hR]hU]uhWM hXhhY]rĢ,(hbX’Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). It is only necessary to specify rĶ,…rĪ,}rĻ,(hBX’Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). It is only necessary to specify hINhWNhXhhCjÉ,ubj[)rŠ,}rŃ,(hBX:cfg-field:`profiling`rŅ,hCjÉ,hIhJhKj_hM}rÓ,(UreftypeX cfg-fieldjaˆjbX profilingU refdomainXcabalrŌ,hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM hY]rÕ,h›)rÖ,}r×,(hBjŅ,hM}rŲ,(hO]hP]rŁ,(jljŌ,Xcabal-cfg-fieldrŚ,ehQ]hR]hU]uhCjŠ,hY]rŪ,hbX profilingrÜ,…rŻ,}rŽ,(hBUhCjÖ,ubahKh£ubaubhbX/ for the specific package you want to profile; rß,…rą,}rį,(hBX/ for the specific package you want to profile; hINhWNhXhhCjÉ,ubh›)rā,}rć,(hBX``cabal new-build``hM}rä,(hO]hP]hQ]hR]hU]uhCjÉ,hY]rå,hbXcabal new-buildrę,…rē,}rč,(hBUhCjā,ubahKh£ubhbXV will ensure that all of its transitive dependencies are built with profiling enabled.ré,…rź,}rė,(hBXV will ensure that all of its transitive dependencies are built with profiling enabled.hINhWNhXhhCjÉ,ubeubhu)rģ,}rķ,(hBX€To enable profiling for only libraries or executables, see :cfg-field:`library-profiling` and :cfg-field:`executable-profiling`.hCj”,hIhJhKhyhM}rī,(hO]hP]hQ]hR]hU]uhWMhXhhY]rļ,(hbX;To enable profiling for only libraries or executables, see rš,…rń,}rņ,(hBX;To enable profiling for only libraries or executables, see hINhWNhXhhCjģ,ubj[)ró,}rō,(hBX:cfg-field:`library-profiling`rõ,hCjģ,hIhJhKj_hM}rö,(UreftypeX cfg-fieldjaˆjbXlibrary-profilingU refdomainXcabalr÷,hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMhY]rų,h›)rł,}rś,(hBjõ,hM}rū,(hO]hP]rü,(jlj÷,Xcabal-cfg-fieldrż,ehQ]hR]hU]uhCjó,hY]rž,hbXlibrary-profilingr’,…r-}r-(hBUhCjł,ubahKh£ubaubhbX and r-…r-}r-(hBX and hINhWNhXhhCjģ,ubj[)r-}r-(hBX!:cfg-field:`executable-profiling`r-hCjģ,hIhJhKj_hM}r-(UreftypeX cfg-fieldjaˆjbXexecutable-profilingU refdomainXcabalr -hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMhY]r -h›)r -}r -(hBj-hM}r -(hO]hP]r-(jlj -Xcabal-cfg-fieldr-ehQ]hR]hU]uhCj-hY]r-hbXexecutable-profilingr-…r-}r-(hBUhCj -ubahKh£ubaubhbX.…r-}r-(hBX.hINhWNhXhhCjģ,ubeubhu)r-}r-(hBX‚For useful profiling, it can be important to control precisely what cost centers are allocated; see :cfg-field:`profiling-detail`.hCj”,hIhJhKhyhM}r-(hO]hP]hQ]hR]hU]uhWMhXhhY]r-(hbXdFor useful profiling, it can be important to control precisely what cost centers are allocated; see r-…r-}r-(hBXdFor useful profiling, it can be important to control precisely what cost centers are allocated; see hINhWNhXhhCj-ubj[)r-}r-(hBX:cfg-field:`profiling-detail`r-hCj-hIhJhKj_hM}r -(UreftypeX cfg-fieldjaˆjbXprofiling-detailU refdomainXcabalr!-hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMhY]r"-h›)r#-}r$-(hBj-hM}r%-(hO]hP]r&-(jlj!-Xcabal-cfg-fieldr'-ehQ]hR]hU]uhCj-hY]r(-hbXprofiling-detailr)-…r*-}r+-(hBUhCj#-ubahKh£ubaubhbX.…r,-}r--(hBX.hINhWNhXhhCj-ubeubhu)r.-}r/-(hBX\The command line variant of this flag is ``--enable-profiling`` and ``--disable-profiling``.hCj”,hIhJhKhyhM}r0-(hO]hP]hQ]hR]hU]uhWMhXhhY]r1-(hbX)The command line variant of this flag is r2-…r3-}r4-(hBX)The command line variant of this flag is hINhWNhXhhCj.-ubh›)r5-}r6-(hBX``--enable-profiling``hM}r7-(hO]hP]hQ]hR]hU]uhCj.-hY]r8-hbX--enable-profilingr9-…r:-}r;-(hBUhCj5-ubahKh£ubhbX and r<-…r=-}r>-(hBX and hINhWNhXhhCj.-ubh›)r?-}r@-(hBX``--disable-profiling``hM}rA-(hO]hP]hQ]hR]hU]uhCj.-hY]rB-hbX--disable-profilingrC-…rD-}rE-(hBUhCj?-ubahKh£ubhbX.…rF-}rG-(hBX.hINhWNhXhhCj.-ubeubeubeubjw)rH-}rI-(hBUhCj+,hIhJhKjzhM}rJ-(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rK-}rL-(hBUhCj+,hIhJhKjhM}rM-(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrN-j…jN-uhWNhXhhY]rO-(j‡)rP-}rQ-(hBXprofiling-detail: levelhCjK-hIhJhKjŠhM}rR-(hR]rS-Xcfg-field-profiling-detailrT-ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rU-(jw)rV-}rW-(hBUhCjP-hIhJhKjzhM}rX-(hR]hQ]hO]hP]hU]Uentries]rY-(j”X'profiling-detail ; cabal project optionjT-UNtrZ-auhWNhXhhY]ubj–)r[-}r\-(hBXprofiling-detailr]-hCjP-hIhJhKjšhM}r^-(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r_-hbXprofiling-detailr`-…ra-}rb-(hBUhINhWNhXhhCj[-ubaubj )rc-}rd-(hBj£hCjP-hIhJhKj¤hM}re-(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rf-hbX: rg-…rh-}ri-(hBUhINhWNhXhhCjc-ubaubjŖ)rj-}rk-(hBXlevelhCjP-hIhJhKj­hM}rl-(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rm-hbXlevelrn-…ro-}rp-(hBUhINhWNhXhhCjj-ubaubeubj‡)rq-}rr-(hBX--profiling-detail=levelhCjK-hIhJhKjŠhM}rs-(hR]rt-Xcfg-flag---profiling-detailru-ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rv-(jw)rw-}rx-(hBUhCjq-hIhJhKjzhM}ry-(hR]hQ]hO]hP]hU]Uentries]rz-(j”X(--profiling-detail; cabal project optionju-UNtr{-auhWNhXhhY]ubj–)r|-}r}-(hBX--profiling-detailr~-hCjq-hIhJhKjšhM}r-(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r€-hbX--profiling-detailr-…r‚-}rƒ-(hBUhINhWNhXhhCj|-ubaubj )r„-}r…-(hBX=levelhCjq-hIhJhKj¤hM}r†-(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‡-hbX=levelrˆ-…r‰-}rŠ-(hBUhINhWNhXhhCj„-ubaubeubj³)r‹-}rŒ-(hBUhCjK-hIhJhKj¶hM}r-(hO]hP]hQ]hR]hU]uhWNhXhhY]rŽ-(j¹)r-}r-(hBUhCj‹-hIhJhKj¼hM}r‘-(hO]hP]hQ]hR]hU]uhWNhXhhY]r’-jæ)r“-}r”-(hBUhCj-hIhJhKjŽhM}r•-(hO]hP]hQ]hR]hU]uhWNhXhhY]r–-(jÄ)r—-}r˜-(hBjæhCj“-hIhJhKjĒhM}r™-(hO]hP]hQ]hR]hU]uhWKhY]rš-hbXSincer›-…rœ-}r-(hBUhCj—-ubaubjĶ)rž-}rŸ-(hBU Cabal 1.23r -hM}r”-(hO]hP]hQ]hR]hU]uhCj“-hY]r¢-hu)r£-}r¤-(hBj -hM}r„-(hO]hP]hQ]hR]hU]uhCjž-hY]r¦-hbX Cabal 1.23r§-…rØ-}r©-(hBUhCj£-ubahKhyubahKjŻubeubaubhu)rŖ-}r«-(hBXGSome 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¬-hCj‹-hIhJhKhyhM}r­-(hO]hP]hQ]hR]hU]uhWMhXhhY]r®-hbXKSome 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Æ-…r°-}r±-(hBj¬-hINhWNhXhhCjŖ-ubaubhu)r²-}r³-(hBXqThis flag covers both libraries and executables, but can be overridden by the ``library-profiling-detail`` field.hCj‹-hIhJhKhyhM}r“-(hO]hP]hQ]hR]hU]uhWM%hXhhY]rµ-(hbXNThis flag covers both libraries and executables, but can be overridden by the r¶-…r·-}rø-(hBXNThis flag covers both libraries and executables, but can be overridden by the hINhWNhXhhCj²-ubh›)r¹-}rŗ-(hBX``library-profiling-detail``hM}r»-(hO]hP]hQ]hR]hU]uhCj²-hY]r¼-hbXlibrary-profiling-detailr½-…r¾-}ræ-(hBUhCj¹-ubahKh£ubhbX field.rĄ-…rĮ-}rĀ-(hBX field.hINhWNhXhhCj²-ubeubhu)rĆ-}rÄ-(hBXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:rÅ-hCj‹-hIhJhKhyhM}rĘ-(hO]hP]hQ]hR]hU]uhWM(hXhhY]rĒ-hbXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:rČ-…rÉ-}rŹ-(hBjÅ-hINhWNhXhhCjĆ-ubaubjE)rĖ-}rĢ-(hBUhCj‹-hIhJhKjHhM}rĶ-(hO]hP]hQ]hR]hU]uhWNhXhhY]rĪ-(jK)rĻ-}rŠ-(hBXjdefault For GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.hCjĖ-hIhJhKjNhM}rŃ-(hO]hP]hQ]hR]hU]uhWM,hY]rŅ-(jQ)rÓ-}rŌ-(hBXdefaultrÕ-hCjĻ-hIhJhKjUhM}rÖ-(hO]hP]hQ]hR]hU]uhWM,hY]r×-hbXdefaultrŲ-…rŁ-}rŚ-(hBjÕ-hCjÓ-ubaubjb)rŪ-}rÜ-(hBUhM}rŻ-(hO]hP]hQ]hR]hU]uhCjĻ-hY]rŽ-hu)rß-}rą-(hBXbFor GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.hCjŪ-hIhJhKhyhM}rį-(hO]hP]hQ]hR]hU]uhWM,hY]rā-(hbXFor GHC this uses rć-…rä-}rå-(hBXFor GHC this uses hCjß-ubh›)rę-}rē-(hBX``exported-functions``hM}rč-(hO]hP]hQ]hR]hU]uhCjß-hY]ré-hbXexported-functionsrź-…rė-}rģ-(hBUhCję-ubahKh£ubhbX for libraries and rķ-…rī-}rļ-(hBX for libraries and hCjß-ubh›)rš-}rń-(hBX``toplevel-functions``hM}rņ-(hO]hP]hQ]hR]hU]uhCjß-hY]ró-hbXtoplevel-functionsrō-…rõ-}rö-(hBUhCjš-ubahKh£ubhbX for executables.r÷-…rų-}rł-(hBX for executables.hCjß-ubeubahKj‚ubeubjK)rś-}rū-(hBXAnone No costs will be assigned to any code within this component.hCjĖ-hIhJhKjNhM}rü-(hO]hP]hQ]hR]hU]uhWM.hXhhY]rż-(jQ)rž-}r’-(hBXnoner.hCjś-hIhJhKjUhM}r.(hO]hP]hQ]hR]hU]uhWM.hY]r.hbXnoner.…r.}r.(hBj.hCjž-ubaubjb)r.}r.(hBUhM}r.(hO]hP]hQ]hR]hU]uhCjś-hY]r .hu)r .}r .(hBX<No costs will be assigned to any code within this component.r .hCj.hIhJhKhyhM}r .(hO]hP]hQ]hR]hU]uhWM/hY]r.hbX<No costs will be assigned to any code within this component.r.…r.}r.(hBj .hCj .ubaubahKj‚ubeubjK)r.}r.(hBXĘ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``.hCjĖ-hIhJhKjNhM}r.(hO]hP]hQ]hR]hU]uhWM2hXhhY]r.(jQ)r.}r.(hBXexported-functionsr.hCj.hIhJhKjUhM}r.(hO]hP]hQ]hR]hU]uhWM2hY]r.hbXexported-functionsr.…r.}r.(hBj.hCj.ubaubjb)r.}r.(hBUhM}r .(hO]hP]hQ]hR]hU]uhCj.hY]r!.hu)r".}r#.(hBX³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``.hCj.hIhJhKhyhM}r$.(hO]hP]hQ]hR]hU]uhWM1hY]r%.(hbXš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&.…r'.}r(.(hBXš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 hCj".ubh›)r).}r*.(hBX``-fprof-auto-exported``hM}r+.(hO]hP]hQ]hR]hU]uhCj".hY]r,.hbX-fprof-auto-exportedr-.…r..}r/.(hBUhCj).ubahKh£ubhbX.…r0.}r1.(hBX.hCj".ubeubahKj‚ubeubjK)r2.}r3.(hBXõ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``.hCjĖ-hIhJhKjNhM}r4.(hO]hP]hQ]hR]hU]uhWM7hXhhY]r5.(jQ)r6.}r7.(hBXtoplevel-functionsr8.hCj2.hIhJhKjUhM}r9.(hO]hP]hQ]hR]hU]uhWM7hY]r:.hbXtoplevel-functionsr;.…r<.}r=.(hBj8.hCj6.ubaubjb)r>.}r?.(hBUhM}r@.(hO]hP]hQ]hR]hU]uhCj2.hY]rA.hu)rB.}rC.(hBXā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``.hCj>.hIhJhKhyhM}rD.(hO]hP]hQ]hR]hU]uhWM5hY]rE.(hbXĪ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 rF.…rG.}rH.(hBXĪ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 hCjB.ubh›)rI.}rJ.(hBX``-fprof-auto-top``hM}rK.(hO]hP]hQ]hR]hU]uhCjB.hY]rL.hbX-fprof-auto-toprM.…rN.}rO.(hBUhCjI.ubahKh£ubhbX.…rP.}rQ.(hBX.hCjB.ubeubahKj‚ubeubjK)rR.}rS.(hBXļ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``. hCjĖ-hIhJhKjNhM}rT.(hO]hP]hQ]hR]hU]uhWM=hXhhY]rU.(jQ)rV.}rW.(hBX all-functionsrX.hCjR.hIhJhKjUhM}rY.(hO]hP]hQ]hR]hU]uhWM=hY]rZ.hbX all-functionsr[.…r\.}r].(hBjX.hCjV.ubaubjb)r^.}r_.(hBUhM}r`.(hO]hP]hQ]hR]hU]uhCjR.hY]ra.hu)rb.}rc.(hBXą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``.hCj^.hIhJhKhyhM}rd.(hO]hP]hQ]hR]hU]uhWM:hY]re.(hbXŠ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 rf.…rg.}rh.(hBXŠ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 hCjb.ubh›)ri.}rj.(hBX``-fprof-auto``hM}rk.(hO]hP]hQ]hR]hU]uhCjb.hY]rl.hbX -fprof-autorm.…rn.}ro.(hBUhCji.ubahKh£ubhbX.…rp.}rq.(hBX.hCjb.ubeubahKj‚ubeubeubhu)rr.}rs.(hBXEThe command line variant of this flag is ``--profiling-detail=none``.hCj‹-hIhJhKhyhM}rt.(hO]hP]hQ]hR]hU]uhWM?hXhhY]ru.(hbX)The command line variant of this flag is rv.…rw.}rx.(hBX)The command line variant of this flag is hINhWNhXhhCjr.ubh›)ry.}rz.(hBX``--profiling-detail=none``hM}r{.(hO]hP]hQ]hR]hU]uhCjr.hY]r|.hbX--profiling-detail=noner}.…r~.}r.(hBUhCjy.ubahKh£ubhbX.…r€.}r.(hBX.hINhWNhXhhCjr.ubeubeubeubjw)r‚.}rƒ.(hBUhCj+,hIhJhKjzhM}r„.(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r….}r†.(hBUhCj+,hIhJhKjhM}r‡.(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrˆ.j…jˆ.uhWNhXhhY]r‰.(j‡)rŠ.}r‹.(hBXlibrary-profiling-detail: levelhCj….hIhJhKjŠhM}rŒ.(hR]r.X"cfg-field-library-profiling-detailrŽ.ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r.(jw)r.}r‘.(hBUhCjŠ.hIhJhKjzhM}r’.(hR]hQ]hO]hP]hU]Uentries]r“.(j”X/library-profiling-detail ; cabal project optionjŽ.UNtr”.auhWNhXhhY]ubj–)r•.}r–.(hBXlibrary-profiling-detailr—.hCjŠ.hIhJhKjšhM}r˜.(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r™.hbXlibrary-profiling-detailrš.…r›.}rœ.(hBUhINhWNhXhhCj•.ubaubj )r.}rž.(hBj£hCjŠ.hIhJhKj¤hM}rŸ.(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r .hbX: r”.…r¢.}r£.(hBUhINhWNhXhhCj.ubaubjŖ)r¤.}r„.(hBXlevelhCjŠ.hIhJhKj­hM}r¦.(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§.hbXlevelrØ.…r©.}rŖ.(hBUhINhWNhXhhCj¤.ubaubeubj‡)r«.}r¬.(hBX --library-profiling-detail=levelhCj….hIhJhKjŠhM}r­.(hR]r®.X#cfg-flag---library-profiling-detailrÆ.ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r°.(jw)r±.}r².(hBUhCj«.hIhJhKjzhM}r³.(hR]hQ]hO]hP]hU]Uentries]r“.(j”X0--library-profiling-detail; cabal project optionjÆ.UNtrµ.auhWNhXhhY]ubj–)r¶.}r·.(hBX--library-profiling-detailrø.hCj«.hIhJhKjšhM}r¹.(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗ.hbX--library-profiling-detailr».…r¼.}r½.(hBUhINhWNhXhhCj¶.ubaubj )r¾.}ræ.(hBX=levelhCj«.hIhJhKj¤hM}rĄ.(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĮ.hbX=levelrĀ.…rĆ.}rÄ.(hBUhINhWNhXhhCj¾.ubaubeubj³)rÅ.}rĘ.(hBUhCj….hIhJhKj¶hM}rĒ.(hO]hP]hQ]hR]hU]uhWNhXhhY]rČ.(j¹)rÉ.}rŹ.(hBUhCjÅ.hIhJhKj¼hM}rĖ.(hO]hP]hQ]hR]hU]uhWNhXhhY]rĢ.jæ)rĶ.}rĪ.(hBUhCjÉ.hIhJhKjŽhM}rĻ.(hO]hP]hQ]hR]hU]uhWNhXhhY]rŠ.(jÄ)rŃ.}rŅ.(hBjæhCjĶ.hIhJhKjĒhM}rÓ.(hO]hP]hQ]hR]hU]uhWKhY]rŌ.hbXSincerÕ.…rÖ.}r×.(hBUhCjŃ.ubaubjĶ)rŲ.}rŁ.(hBU Cabal 1.23rŚ.hM}rŪ.(hO]hP]hQ]hR]hU]uhCjĶ.hY]rÜ.hu)rŻ.}rŽ.(hBjŚ.hM}rß.(hO]hP]hQ]hR]hU]uhCjŲ.hY]rą.hbX Cabal 1.23rį.…rā.}rć.(hBUhCjŻ.ubahKhyubahKjŻubeubaubhu)rä.}rå.(hBXALike :cfg-field:`profiling-detail`, but applied only to librarieshCjÅ.hIhJhKhyhM}rę.(hO]hP]hQ]hR]hU]uhWMGhXhhY]rē.(hbXLike rč.…ré.}rź.(hBXLike hINhWNhXhhCjä.ubj[)rė.}rģ.(hBX:cfg-field:`profiling-detail`rķ.hCjä.hIhJhKj_hM}rī.(UreftypeX cfg-fieldjaˆjbXprofiling-detailU refdomainXcabalrļ.hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMGhY]rš.h›)rń.}rņ.(hBjķ.hM}ró.(hO]hP]rō.(jljļ.Xcabal-cfg-fieldrõ.ehQ]hR]hU]uhCjė.hY]rö.hbXprofiling-detailr÷.…rų.}rł.(hBUhCjń.ubahKh£ubaubhbX, but applied only to librariesrś.…rū.}rü.(hBX, but applied only to librarieshINhWNhXhhCjä.ubeubhu)rż.}rž.(hBXMThe command line variant of this flag is ``--library-profiling-detail=none``.hCjÅ.hIhJhKhyhM}r’.(hO]hP]hQ]hR]hU]uhWMIhXhhY]r/(hbX)The command line variant of this flag is r/…r/}r/(hBX)The command line variant of this flag is hINhWNhXhhCjż.ubh›)r/}r/(hBX#``--library-profiling-detail=none``hM}r/(hO]hP]hQ]hR]hU]uhCjż.hY]r/hbX--library-profiling-detail=noner/…r /}r /(hBUhCj/ubahKh£ubhbX.…r /}r /(hBX.hINhWNhXhhCjż.ubeubeubeubjw)r /}r/(hBUhCj+,hIhJhKjzhM}r/(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r/}r/(hBUhCj+,hIhJhKjhM}r/(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr/j…j/uhWNhXhhY]r/(j‡)r/}r/(hBXlibrary-vanilla: booleanhCj/hIhJhKjŠhM}r/(hR]r/Xcfg-field-library-vanillar/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r/(jw)r/}r/(hBUhCj/hIhJhKjzhM}r/(hR]hQ]hO]hP]hU]Uentries]r/(j”X&library-vanilla ; cabal project optionj/UNtr/auhWNhXhhY]ubj–)r /}r!/(hBXlibrary-vanillar"/hCj/hIhJhKjšhM}r#/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r$/hbXlibrary-vanillar%/…r&/}r'/(hBUhINhWNhXhhCj /ubaubj )r(/}r)/(hBj£hCj/hIhJhKj¤hM}r*/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r+/hbX: r,/…r-/}r./(hBUhINhWNhXhhCj(/ubaubjŖ)r//}r0/(hBXbooleanhCj/hIhJhKj­hM}r1/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r2/hbXbooleanr3/…r4/}r5/(hBUhINhWNhXhhCj//ubaubeubj‡)r6/}r7/(hBX--enable-library-vanillar8/hCj/hIhJhKjŠhM}r9/(hR]r:/X!cfg-flag---enable-library-vanillar;/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r/(hBUhCj6/hIhJhKjzhM}r?/(hR]hQ]hO]hP]hU]Uentries]r@/(j”X.--enable-library-vanilla; cabal project optionj;/UNtrA/auhWNhXhhY]ubj–)rB/}rC/(hBj8/hCj6/hIhJhKjšhM}rD/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rE/hbX--enable-library-vanillarF/…rG/}rH/(hBUhINhWNhXhhCjB/ubaubj )rI/}rJ/(hBU hCj6/hIhJhKj¤hM}rK/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rL/hbX …rM/}rN/(hBUhINhWNhXhhCjI/ubaubeubj‡)rO/}rP/(hBX--disable-library-vanillarQ/hCj/hIhJhKjŠhM}rR/(hR]rS/X"cfg-flag---disable-library-vanillarT/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rU/(jw)rV/}rW/(hBUhCjO/hIhJhKjzhM}rX/(hR]hQ]hO]hP]hU]Uentries]rY/(j”X/--disable-library-vanilla; cabal project optionjT/UNtrZ/auhWNhXhhY]ubj–)r[/}r\/(hBjQ/hCjO/hIhJhKjšhM}r]/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r^/hbX--disable-library-vanillar_/…r`/}ra/(hBUhINhWNhXhhCj[/ubaubj )rb/}rc/(hBU hCjO/hIhJhKj¤hM}rd/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]re/hbX …rf/}rg/(hBUhINhWNhXhhCjb/ubaubeubj³)rh/}ri/(hBUhCj/hIhJhKj¶hM}rj/(hO]hP]hQ]hR]hU]uhWNhXhhY]rk/(j¹)rl/}rm/(hBUhCjh/hIhJhKj¼hM}rn/(hO]hP]hQ]hR]hU]uhWNhXhhY]ro/jæ)rp/}rq/(hBUhM}rr/(hO]hP]hQ]hR]hU]uhCjl/hY]rs/(jÄ)rt/}ru/(hBX Default valuehCjp/hIhJhKjĒhM}rv/(hO]hP]hQ]hR]hU]uhWKhY]rw/hbX Default valuerx/…ry/}rz/(hBUhCjt/ubaubjĶ)r{/}r|/(hBUhM}r}/(hO]hP]hQ]hR]hU]uhCjp/hY]r~/hu)r/}r€/(hBXTruehM}r/(hO]hP]hQ]hR]hU]uhCj{/hY]r‚/hbXTruerƒ/…r„/}r…/(hBXTruer†/hINhWNhXhhCj/ubahKhyubahKjŻubehKjŽubaubhu)r‡/}rˆ/(hBXœBuild ordinary libraries (as opposed to profiling libraries). Mostly, you can set this to False to avoid building ordinary libraries when you are profiling.r‰/hCjh/hIhJhKhyhM}rŠ/(hO]hP]hQ]hR]hU]uhWMShXhhY]r‹/hbXœBuild ordinary libraries (as opposed to profiling libraries). Mostly, you can set this to False to avoid building ordinary libraries when you are profiling.rŒ/…r/}rŽ/(hBj‰/hINhWNhXhhCj‡/ubaubhu)r/}r/(hBXhThe command line variant of this flag is ``--enable-library-vanilla`` and ``--disable-library-vanilla``.hCjh/hIhJhKhyhM}r‘/(hO]hP]hQ]hR]hU]uhWMWhXhhY]r’/(hbX)The command line variant of this flag is r“/…r”/}r•/(hBX)The command line variant of this flag is hINhWNhXhhCj/ubh›)r–/}r—/(hBX``--enable-library-vanilla``hM}r˜/(hO]hP]hQ]hR]hU]uhCj/hY]r™/hbX--enable-library-vanillarš/…r›/}rœ/(hBUhCj–/ubahKh£ubhbX and r/…rž/}rŸ/(hBX and hINhWNhXhhCj/ubh›)r /}r”/(hBX``--disable-library-vanilla``hM}r¢/(hO]hP]hQ]hR]hU]uhCj/hY]r£/hbX--disable-library-vanillar¤/…r„/}r¦/(hBUhCj /ubahKh£ubhbX.…r§/}rØ/(hBX.hINhWNhXhhCj/ubeubeubeubjw)r©/}rŖ/(hBUhCj+,hIhJhKjzhM}r«/(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r¬/}r­/(hBUhCj+,hIhJhKjhM}r®/(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÆ/j…jÆ/uhWNhXhhY]r°/(j‡)r±/}r²/(hBXlibrary-profiling: booleanhCj¬/hIhJhKjŠhM}r³/(hR]r“/Xcfg-field-library-profilingrµ/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r¶/(jw)r·/}rø/(hBUhCj±/hIhJhKjzhM}r¹/(hR]hQ]hO]hP]hU]Uentries]rŗ/(j”X(library-profiling ; cabal project optionjµ/UNtr»/auhWNhXhhY]ubj–)r¼/}r½/(hBXlibrary-profilingr¾/hCj±/hIhJhKjšhM}ræ/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĄ/hbXlibrary-profilingrĮ/…rĀ/}rĆ/(hBUhINhWNhXhhCj¼/ubaubj )rÄ/}rÅ/(hBj£hCj±/hIhJhKj¤hM}rĘ/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĒ/hbX: rČ/…rÉ/}rŹ/(hBUhINhWNhXhhCjÄ/ubaubjŖ)rĖ/}rĢ/(hBXbooleanhCj±/hIhJhKj­hM}rĶ/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĪ/hbXbooleanrĻ/…rŠ/}rŃ/(hBUhINhWNhXhhCjĖ/ubaubeubj‡)rŅ/}rÓ/(hBX--enable-library-profilingrŌ/hCj¬/hIhJhKjŠhM}rÕ/(hR]rÖ/X#cfg-flag---enable-library-profilingr×/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŲ/(jw)rŁ/}rŚ/(hBUhCjŅ/hIhJhKjzhM}rŪ/(hR]hQ]hO]hP]hU]Uentries]rÜ/(j”X0--enable-library-profiling; cabal project optionj×/UNtrŻ/auhWNhXhhY]ubj–)rŽ/}rß/(hBjŌ/hCjŅ/hIhJhKjšhM}rą/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rį/hbX--enable-library-profilingrā/…rć/}rä/(hBUhINhWNhXhhCjŽ/ubaubj )rå/}rę/(hBU hCjŅ/hIhJhKj¤hM}rē/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rč/hbX …ré/}rź/(hBUhINhWNhXhhCjå/ubaubeubj‡)rė/}rģ/(hBX--disable-library-profilingrķ/hCj¬/hIhJhKjŠhM}rī/(hR]rļ/X$cfg-flag---disable-library-profilingrš/ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rń/(jw)rņ/}ró/(hBUhCjė/hIhJhKjzhM}rō/(hR]hQ]hO]hP]hU]Uentries]rõ/(j”X1--disable-library-profiling; cabal project optionjš/UNtrö/auhWNhXhhY]ubj–)r÷/}rų/(hBjķ/hCjė/hIhJhKjšhM}rł/(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rś/hbX--disable-library-profilingrū/…rü/}rż/(hBUhINhWNhXhhCj÷/ubaubj )rž/}r’/(hBU hCjė/hIhJhKj¤hM}r0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r0hbX …r0}r0(hBUhINhWNhXhhCjž/ubaubeubj³)r0}r0(hBUhCj¬/hIhJhKj¶hM}r0(hO]hP]hQ]hR]hU]uhWNhXhhY]r0(j¹)r0}r 0(hBUhCj0hIhJhKj¼hM}r 0(hO]hP]hQ]hR]hU]uhWNhXhhY]r 0(jæ)r 0}r 0(hBUhCj0hIhJhKjŽhM}r0(hO]hP]hQ]hR]hU]uhWNhXhhY]r0(jÄ)r0}r0(hBjæhCj 0hIhJhKjĒhM}r0(hO]hP]hQ]hR]hU]uhWKhY]r0hbXSincer0…r0}r0(hBUhCj0ubaubjĶ)r0}r0(hBU Cabal 1.21r0hM}r0(hO]hP]hQ]hR]hU]uhCj 0hY]r0hu)r0}r0(hBj0hM}r0(hO]hP]hQ]hR]hU]uhCj0hY]r0hbX Cabal 1.21r 0…r!0}r"0(hBUhCj0ubahKhyubahKjŻubeubjæ)r#0}r$0(hBUhM}r%0(hO]hP]hQ]hR]hU]uhCj0hY]r&0(jÄ)r'0}r(0(hBX Default valuehCj#0hIhJhKjĒhM}r)0(hO]hP]hQ]hR]hU]uhWKhY]r*0hbX Default valuer+0…r,0}r-0(hBUhCj'0ubaubjĶ)r.0}r/0(hBUhM}r00(hO]hP]hQ]hR]hU]uhCj#0hY]r10hu)r20}r30(hBXFalsehM}r40(hO]hP]hQ]hR]hU]uhCj.0hY]r50hbXFalser60…r70}r80(hBXFalsehINhWNhXhhCj20ubahKhyubahKjŻubehKjŽubeubhu)r90}r:0(hBXaBuild libraries with profiling enabled. You probably want to use :cfg-field:`profiling` instead.hCj0hIhJhKhyhM}r;0(hO]hP]hQ]hR]hU]uhWMbhXhhY]r<0(hbXBBuild libraries with profiling enabled. You probably want to use r=0…r>0}r?0(hBXBBuild libraries with profiling enabled. You probably want to use hINhWNhXhhCj90ubj[)r@0}rA0(hBX:cfg-field:`profiling`rB0hCj90hIhJhKj_hM}rC0(UreftypeX cfg-fieldjaˆjbX profilingU refdomainXcabalrD0hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMbhY]rE0h›)rF0}rG0(hBjB0hM}rH0(hO]hP]rI0(jljD0Xcabal-cfg-fieldrJ0ehQ]hR]hU]uhCj@0hY]rK0hbX profilingrL0…rM0}rN0(hBUhCjF0ubahKh£ubaubhbX instead.rO0…rP0}rQ0(hBX instead.hINhWNhXhhCj90ubeubhu)rR0}rS0(hBXlThe command line variant of this flag is ``--enable-library-profiling`` and ``--disable-library-profiling``.hCj0hIhJhKhyhM}rT0(hO]hP]hQ]hR]hU]uhWMehXhhY]rU0(hbX)The command line variant of this flag is rV0…rW0}rX0(hBX)The command line variant of this flag is hINhWNhXhhCjR0ubh›)rY0}rZ0(hBX``--enable-library-profiling``hM}r[0(hO]hP]hQ]hR]hU]uhCjR0hY]r\0hbX--enable-library-profilingr]0…r^0}r_0(hBUhCjY0ubahKh£ubhbX and r`0…ra0}rb0(hBX and hINhWNhXhhCjR0ubh›)rc0}rd0(hBX``--disable-library-profiling``hM}re0(hO]hP]hQ]hR]hU]uhCjR0hY]rf0hbX--disable-library-profilingrg0…rh0}ri0(hBUhCjc0ubahKh£ubhbX.…rj0}rk0(hBX.hINhWNhXhhCjR0ubeubeubeubjw)rl0}rm0(hBUhCj+,hIhJhKjzhM}rn0(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)ro0}rp0(hBUhCj+,hIhJhKjhM}rq0(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrr0j…jr0uhWNhXhhY]rs0(j‡)rt0}ru0(hBXexecutable-profiling: booleanhCjo0hIhJhKjŠhM}rv0(hR]rw0Xcfg-field-executable-profilingrx0ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]ry0(jw)rz0}r{0(hBUhCjt0hIhJhKjzhM}r|0(hR]hQ]hO]hP]hU]Uentries]r}0(j”X+executable-profiling ; cabal project optionjx0UNtr~0auhWNhXhhY]ubj–)r0}r€0(hBXexecutable-profilingr0hCjt0hIhJhKjšhM}r‚0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rƒ0hbXexecutable-profilingr„0…r…0}r†0(hBUhINhWNhXhhCj0ubaubj )r‡0}rˆ0(hBj£hCjt0hIhJhKj¤hM}r‰0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠ0hbX: r‹0…rŒ0}r0(hBUhINhWNhXhhCj‡0ubaubjŖ)rŽ0}r0(hBXbooleanhCjt0hIhJhKj­hM}r0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‘0hbXbooleanr’0…r“0}r”0(hBUhINhWNhXhhCjŽ0ubaubeubj‡)r•0}r–0(hBX--enable-executable-profilingr—0hCjo0hIhJhKjŠhM}r˜0(hR]r™0X&cfg-flag---enable-executable-profilingrš0ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r›0(jw)rœ0}r0(hBUhCj•0hIhJhKjzhM}rž0(hR]hQ]hO]hP]hU]Uentries]rŸ0(j”X3--enable-executable-profiling; cabal project optionjš0UNtr 0auhWNhXhhY]ubj–)r”0}r¢0(hBj—0hCj•0hIhJhKjšhM}r£0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¤0hbX--enable-executable-profilingr„0…r¦0}r§0(hBUhINhWNhXhhCj”0ubaubj )rØ0}r©0(hBU hCj•0hIhJhKj¤hM}rŖ0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r«0hbX …r¬0}r­0(hBUhINhWNhXhhCjØ0ubaubeubj‡)r®0}rÆ0(hBX--disable-executable-profilingr°0hCjo0hIhJhKjŠhM}r±0(hR]r²0X'cfg-flag---disable-executable-profilingr³0ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r“0(jw)rµ0}r¶0(hBUhCj®0hIhJhKjzhM}r·0(hR]hQ]hO]hP]hU]Uentries]rø0(j”X4--disable-executable-profiling; cabal project optionj³0UNtr¹0auhWNhXhhY]ubj–)rŗ0}r»0(hBj°0hCj®0hIhJhKjšhM}r¼0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r½0hbX--disable-executable-profilingr¾0…ræ0}rĄ0(hBUhINhWNhXhhCjŗ0ubaubj )rĮ0}rĀ0(hBU hCj®0hIhJhKj¤hM}rĆ0(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÄ0hbX …rÅ0}rĘ0(hBUhINhWNhXhhCjĮ0ubaubeubj³)rĒ0}rČ0(hBUhCjo0hIhJhKj¶hM}rÉ0(hO]hP]hQ]hR]hU]uhWNhXhhY]rŹ0(j¹)rĖ0}rĢ0(hBUhCjĒ0hIhJhKj¼hM}rĶ0(hO]hP]hQ]hR]hU]uhWNhXhhY]rĪ0(jæ)rĻ0}rŠ0(hBUhCjĖ0hIhJhKjŽhM}rŃ0(hO]hP]hQ]hR]hU]uhWNhXhhY]rŅ0(jÄ)rÓ0}rŌ0(hBjæhCjĻ0hIhJhKjĒhM}rÕ0(hO]hP]hQ]hR]hU]uhWKhY]rÖ0hbXSincer×0…rŲ0}rŁ0(hBUhCjÓ0ubaubjĶ)rŚ0}rŪ0(hBU Cabal 1.21rÜ0hM}rŻ0(hO]hP]hQ]hR]hU]uhCjĻ0hY]rŽ0hu)rß0}rą0(hBjÜ0hM}rį0(hO]hP]hQ]hR]hU]uhCjŚ0hY]rā0hbX Cabal 1.21rć0…rä0}rå0(hBUhCjß0ubahKhyubahKjŻubeubjæ)rę0}rē0(hBUhM}rč0(hO]hP]hQ]hR]hU]uhCjĖ0hY]ré0(jÄ)rź0}rė0(hBX Default valuehCję0hIhJhKjĒhM}rģ0(hO]hP]hQ]hR]hU]uhWKhY]rķ0hbX Default valuerī0…rļ0}rš0(hBUhCjź0ubaubjĶ)rń0}rņ0(hBUhM}ró0(hO]hP]hQ]hR]hU]uhCję0hY]rō0hu)rõ0}rö0(hBXFalsehM}r÷0(hO]hP]hQ]hR]hU]uhCjń0hY]rų0hbXFalserł0…rś0}rū0(hBXFalsehINhWNhXhhCjõ0ubahKhyubahKjŻubehKjŽubeubhu)rü0}rż0(hBXbBuild executables with profiling enabled. You probably want to use :cfg-field:`profiling` instead.hCjĒ0hIhJhKhyhM}rž0(hO]hP]hQ]hR]hU]uhWMphXhhY]r’0(hbXCBuild executables with profiling enabled. You probably want to use r1…r1}r1(hBXCBuild executables with profiling enabled. You probably want to use hINhWNhXhhCjü0ubj[)r1}r1(hBX:cfg-field:`profiling`r1hCjü0hIhJhKj_hM}r1(UreftypeX cfg-fieldjaˆjbX profilingU refdomainXcabalr1hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWMphY]r1h›)r 1}r 1(hBj1hM}r 1(hO]hP]r 1(jlj1Xcabal-cfg-fieldr 1ehQ]hR]hU]uhCj1hY]r1hbX profilingr1…r1}r1(hBUhCj 1ubahKh£ubaubhbX instead.r1…r1}r1(hBX instead.hINhWNhXhhCjü0ubeubhu)r1}r1(hBXrThe command line variant of this flag is ``--enable-executable-profiling`` and ``--disable-executable-profiling``.hCjĒ0hIhJhKhyhM}r1(hO]hP]hQ]hR]hU]uhWMshXhhY]r1(hbX)The command line variant of this flag is r1…r1}r1(hBX)The command line variant of this flag is hINhWNhXhhCj1ubh›)r1}r1(hBX!``--enable-executable-profiling``hM}r1(hO]hP]hQ]hR]hU]uhCj1hY]r1hbX--enable-executable-profilingr 1…r!1}r"1(hBUhCj1ubahKh£ubhbX and r#1…r$1}r%1(hBX and hINhWNhXhhCj1ubh›)r&1}r'1(hBX"``--disable-executable-profiling``hM}r(1(hO]hP]hQ]hR]hU]uhCj1hY]r)1hbX--disable-executable-profilingr*1…r+1}r,1(hBUhCj&1ubahKh£ubhbX.…r-1}r.1(hBX.hINhWNhXhhCj1ubeubeubeubeubhD)r/1}r01(hBUhCj™hIhJhKhLhM}r11(hO]hP]hQ]hR]r21jé ahU]r31h'auhWMxhXhhY]r41(h[)r51}r61(hBXCoverage optionsr71hCj/1hIhJhKh_hM}r81(hO]hP]hQ]hR]hU]uhWMxhXhhY]r91hbXCoverage optionsr:1…r;1}r<1(hBj71hINhWNhXhhCj51ubaubjw)r=1}r>1(hBUhCj/1hIhJhKjzhM}r?1(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r@1}rA1(hBUhCj/1hIhJhKjhM}rB1(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrC1j…jC1uhWNhXhhY]rD1(j‡)rE1}rF1(hBXcoverage: booleanhCj@1hIhJhKjŠhM}rG1(hR]rH1Xcfg-field-coveragerI1ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rJ1(jw)rK1}rL1(hBUhCjE1hIhJhKjzhM}rM1(hR]hQ]hO]hP]hU]Uentries]rN1(j”Xcoverage ; cabal project optionjI1UNtrO1auhWNhXhhY]ubj–)rP1}rQ1(hBXcoveragerR1hCjE1hIhJhKjšhM}rS1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rT1hbXcoveragerU1…rV1}rW1(hBUhINhWNhXhhCjP1ubaubj )rX1}rY1(hBj£hCjE1hIhJhKj¤hM}rZ1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r[1hbX: r\1…r]1}r^1(hBUhINhWNhXhhCjX1ubaubjŖ)r_1}r`1(hBXbooleanhCjE1hIhJhKj­hM}ra1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rb1hbXbooleanrc1…rd1}re1(hBUhINhWNhXhhCj_1ubaubeubj‡)rf1}rg1(hBX--enable-coveragerh1hCj@1hIhJhKjŠhM}ri1(hR]rj1Xcfg-flag---enable-coveragerk1ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rl1(jw)rm1}rn1(hBUhCjf1hIhJhKjzhM}ro1(hR]hQ]hO]hP]hU]Uentries]rp1(j”X'--enable-coverage; cabal project optionjk1UNtrq1auhWNhXhhY]ubj–)rr1}rs1(hBjh1hCjf1hIhJhKjšhM}rt1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ru1hbX--enable-coveragerv1…rw1}rx1(hBUhINhWNhXhhCjr1ubaubj )ry1}rz1(hBU hCjf1hIhJhKj¤hM}r{1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r|1hbX …r}1}r~1(hBUhINhWNhXhhCjy1ubaubeubj‡)r1}r€1(hBX--disable-coverager1hCj@1hIhJhKjŠhM}r‚1(hR]rƒ1Xcfg-flag---disable-coverager„1ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r…1(jw)r†1}r‡1(hBUhCj1hIhJhKjzhM}rˆ1(hR]hQ]hO]hP]hU]Uentries]r‰1(j”X(--disable-coverage; cabal project optionj„1UNtrŠ1auhWNhXhhY]ubj–)r‹1}rŒ1(hBj1hCj1hIhJhKjšhM}r1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŽ1hbX--disable-coverager1…r1}r‘1(hBUhINhWNhXhhCj‹1ubaubj )r’1}r“1(hBU hCj1hIhJhKj¤hM}r”1(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r•1hbX …r–1}r—1(hBUhINhWNhXhhCj’1ubaubeubj³)r˜1}r™1(hBUhCj@1hIhJhKj¶hM}rš1(hO]hP]hQ]hR]hU]uhWNhXhhY]r›1(j¹)rœ1}r1(hBUhCj˜1hIhJhKj¼hM}rž1(hO]hP]hQ]hR]hU]uhWNhXhhY]rŸ1(jæ)r 1}r”1(hBUhCjœ1hIhJhKjŽhM}r¢1(hO]hP]hQ]hR]hU]uhWNhXhhY]r£1(jÄ)r¤1}r„1(hBjæhCj 1hIhJhKjĒhM}r¦1(hO]hP]hQ]hR]hU]uhWKhY]r§1hbXSincerØ1…r©1}rŖ1(hBUhCj¤1ubaubjĶ)r«1}r¬1(hBU Cabal 1.21r­1hM}r®1(hO]hP]hQ]hR]hU]uhCj 1hY]rÆ1hu)r°1}r±1(hBj­1hM}r²1(hO]hP]hQ]hR]hU]uhCj«1hY]r³1hbX Cabal 1.21r“1…rµ1}r¶1(hBUhCj°1ubahKhyubahKjŻubeubjæ)r·1}rø1(hBUhM}r¹1(hO]hP]hQ]hR]hU]uhCjœ1hY]rŗ1(jÄ)r»1}r¼1(hBX Default valuehCj·1hIhJhKjĒhM}r½1(hO]hP]hQ]hR]hU]uhWKhY]r¾1hbX Default valueræ1…rĄ1}rĮ1(hBUhCj»1ubaubjĶ)rĀ1}rĆ1(hBUhM}rÄ1(hO]hP]hQ]hR]hU]uhCj·1hY]rÅ1hu)rĘ1}rĒ1(hBXFalsehM}rČ1(hO]hP]hQ]hR]hU]uhCjĀ1hY]rÉ1hbXFalserŹ1…rĖ1}rĢ1(hBXFalsehINhWNhXhhCjĘ1ubahKhyubahKjŻubehKjŽubeubhu)rĶ1}rĪ1(hBX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.rĻ1hCj˜1hIhJhKhyhM}rŠ1(hO]hP]hQ]hR]hU]uhWM‚hXhhY]rŃ1hbX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.rŅ1…rÓ1}rŌ1(hBjĻ1hINhWNhXhhCjĶ1ubaubhu)rÕ1}rÖ1(hBXZThe command line variant of this flag is ``--enable-coverage`` and ``--disable-coverage``.hCj˜1hIhJhKhyhM}r×1(hO]hP]hQ]hR]hU]uhWM†hXhhY]rŲ1(hbX)The command line variant of this flag is rŁ1…rŚ1}rŪ1(hBX)The command line variant of this flag is hINhWNhXhhCjÕ1ubh›)rÜ1}rŻ1(hBX``--enable-coverage``hM}rŽ1(hO]hP]hQ]hR]hU]uhCjÕ1hY]rß1hbX--enable-coveragerą1…rį1}rā1(hBUhCjÜ1ubahKh£ubhbX and rć1…rä1}rå1(hBX and hINhWNhXhhCjÕ1ubh›)rę1}rē1(hBX``--disable-coverage``hM}rč1(hO]hP]hQ]hR]hU]uhCjÕ1hY]ré1hbX--disable-coveragerź1…rė1}rģ1(hBUhCję1ubahKh£ubhbX.…rķ1}rī1(hBX.hINhWNhXhhCjÕ1ubeubeubeubjw)rļ1}rš1(hBUhCj/1hIhJhKjzhM}rń1(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rņ1}ró1(hBUhCj/1hIhJhKjhM}rō1(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrõ1j…jõ1uhWNhXhhY]rö1(j‡)r÷1}rų1(hBXlibrary-coverage: booleanhCjņ1hIhJhKjŠhM}rł1(hR]rś1Xcfg-field-library-coveragerū1ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rü1(jw)rż1}rž1(hBUhCj÷1hIhJhKjzhM}r’1(hR]hQ]hO]hP]hU]Uentries]r2(j”X'library-coverage ; cabal project optionjū1UNtr2auhWNhXhhY]ubj–)r2}r2(hBXlibrary-coverager2hCj÷1hIhJhKjšhM}r2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r2hbXlibrary-coverager2…r2}r 2(hBUhINhWNhXhhCj2ubaubj )r 2}r 2(hBj£hCj÷1hIhJhKj¤hM}r 2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r 2hbX: r2…r2}r2(hBUhINhWNhXhhCj 2ubaubjŖ)r2}r2(hBXbooleanhCj÷1hIhJhKj­hM}r2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r2hbXbooleanr2…r2}r2(hBUhINhWNhXhhCj2ubaubeubj‡)r2}r2(hBX--enable-library-coverager2hCjņ1hIhJhKjŠhM}r2(hR]r2X"cfg-flag---enable-library-coverager2ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r2(jw)r2}r 2(hBUhCj2hIhJhKjzhM}r!2(hR]hQ]hO]hP]hU]Uentries]r"2(j”X/--enable-library-coverage; cabal project optionj2UNtr#2auhWNhXhhY]ubj–)r$2}r%2(hBj2hCj2hIhJhKjšhM}r&2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r'2hbX--enable-library-coverager(2…r)2}r*2(hBUhINhWNhXhhCj$2ubaubj )r+2}r,2(hBU hCj2hIhJhKj¤hM}r-2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r.2hbX …r/2}r02(hBUhINhWNhXhhCj+2ubaubeubj‡)r12}r22(hBX--disable-library-coverager32hCjņ1hIhJhKjŠhM}r42(hR]r52X#cfg-flag---disable-library-coverager62ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r72(jw)r82}r92(hBUhCj12hIhJhKjzhM}r:2(hR]hQ]hO]hP]hU]Uentries]r;2(j”X0--disable-library-coverage; cabal project optionj62UNtr<2auhWNhXhhY]ubj–)r=2}r>2(hBj32hCj12hIhJhKjšhM}r?2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r@2hbX--disable-library-coveragerA2…rB2}rC2(hBUhINhWNhXhhCj=2ubaubj )rD2}rE2(hBU hCj12hIhJhKj¤hM}rF2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rG2hbX …rH2}rI2(hBUhINhWNhXhhCjD2ubaubeubj³)rJ2}rK2(hBUhCjņ1hIhJhKj¶hM}rL2(hO]hP]hQ]hR]hU]uhWNhXhhY]rM2(j¹)rN2}rO2(hBUhCjJ2hIhJhKj¼hM}rP2(hO]hP]hQ]hR]hU]uhWNhXhhY]rQ2(jæ)rR2}rS2(hBUhCjN2hIhJhKjŽhM}rT2(hO]hP]hQ]hR]hU]uhWNhXhhY]rU2(jÄ)rV2}rW2(hBU DeprecatedrX2hCjR2hIhJhKjĒhM}rY2(hO]hP]hQ]hR]hU]uhWKhY]rZ2hbX Deprecatedr[2…r\2}r]2(hBUhCjV2ubaubjĶ)r^2}r_2(hBUhM}r`2(hO]hP]hQ]hR]hU]uhCjR2hY]ra2hu)rb2}rc2(hBUhM}rd2(hO]hP]hQ]hR]hU]uhCj^2hY]hKhyubahKjŻubeubjæ)re2}rf2(hBUhCjN2hIhJhKjŽhM}rg2(hO]hP]hQ]hR]hU]uhWNhXhhY]rh2(jÄ)ri2}rj2(hBjæhCje2hIhJhKjĒhM}rk2(hO]hP]hQ]hR]hU]uhWKhY]rl2hbXSincerm2…rn2}ro2(hBUhCji2ubaubjĶ)rp2}rq2(hBU Cabal 1.21rr2hM}rs2(hO]hP]hQ]hR]hU]uhCje2hY]rt2hu)ru2}rv2(hBjr2hM}rw2(hO]hP]hQ]hR]hU]uhCjp2hY]rx2hbX Cabal 1.21ry2…rz2}r{2(hBUhCju2ubahKhyubahKjŻubeubjæ)r|2}r}2(hBUhM}r~2(hO]hP]hQ]hR]hU]uhCjN2hY]r2(jÄ)r€2}r2(hBX Default valuehCj|2hIhJhKjĒhM}r‚2(hO]hP]hQ]hR]hU]uhWKhY]rƒ2hbX Default valuer„2…r…2}r†2(hBUhCj€2ubaubjĶ)r‡2}rˆ2(hBUhM}r‰2(hO]hP]hQ]hR]hU]uhCj|2hY]rŠ2hu)r‹2}rŒ2(hBXFalsehM}r2(hO]hP]hQ]hR]hU]uhCj‡2hY]rŽ2hbXFalser2…r2}r‘2(hBXFalsehINhWNhXhhCj‹2ubahKhyubahKjŻubehKjŽubeubhu)r’2}r“2(hBX&Deprecated, use :cfg-field:`coverage`.hCjJ2hIhJhKhyhM}r”2(hO]hP]hQ]hR]hU]uhWM‘hXhhY]r•2(hbXDeprecated, use r–2…r—2}r˜2(hBXDeprecated, use hINhWNhXhhCj’2ubj[)r™2}rš2(hBX:cfg-field:`coverage`r›2hCj’2hIhJhKj_hM}rœ2(UreftypeX cfg-fieldjaˆjbXcoverageU refdomainXcabalr2hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM‘hY]rž2h›)rŸ2}r 2(hBj›2hM}r”2(hO]hP]r¢2(jlj2Xcabal-cfg-fieldr£2ehQ]hR]hU]uhCj™2hY]r¤2hbXcoverager„2…r¦2}r§2(hBUhCjŸ2ubahKh£ubaubhbX.…rØ2}r©2(hBX.hINhWNhXhhCj’2ubeubhu)rŖ2}r«2(hBXjThe command line variant of this flag is ``--enable-library-coverage`` and ``--disable-library-coverage``.hCjJ2hIhJhKhyhM}r¬2(hO]hP]hQ]hR]hU]uhWM“hXhhY]r­2(hbX)The command line variant of this flag is r®2…rÆ2}r°2(hBX)The command line variant of this flag is hINhWNhXhhCjŖ2ubh›)r±2}r²2(hBX``--enable-library-coverage``hM}r³2(hO]hP]hQ]hR]hU]uhCjŖ2hY]r“2hbX--enable-library-coveragerµ2…r¶2}r·2(hBUhCj±2ubahKh£ubhbX and rø2…r¹2}rŗ2(hBX and hINhWNhXhhCjŖ2ubh›)r»2}r¼2(hBX``--disable-library-coverage``hM}r½2(hO]hP]hQ]hR]hU]uhCjŖ2hY]r¾2hbX--disable-library-coverageræ2…rĄ2}rĮ2(hBUhCj»2ubahKh£ubhbX.…rĀ2}rĆ2(hBX.hINhWNhXhhCjŖ2ubeubeubeubeubhD)rÄ2}rÅ2(hBUhCj™hIhJhKhLhM}rĘ2(hO]hP]hQ]hR]rĒ2jÓ ahU]rČ2h auhWM—hXhhY]rÉ2(h[)rŹ2}rĖ2(hBXHaddock optionsrĢ2hCjÄ2hIhJhKh_hM}rĶ2(hO]hP]hQ]hR]hU]uhWM—hXhhY]rĪ2hbXHaddock optionsrĻ2…rŠ2}rŃ2(hBjĢ2hINhWNhXhhCjŹ2ubaubjw)rŅ2}rÓ2(hBUhCjÄ2hIhJhKjzhM}rŌ2(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rÕ2}rÖ2(hBUhCjÄ2hIhJhKjhM}r×2(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrŲ2j…jŲ2uhWNhXhhY]rŁ2(j‡)rŚ2}rŪ2(hBXdocumentation: booleanhCjÕ2hIhJhKjŠhM}rÜ2(hR]rŻ2Xcfg-field-documentationrŽ2ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rß2(jw)rą2}rį2(hBUhCjŚ2hIhJhKjzhM}rā2(hR]hQ]hO]hP]hU]Uentries]rć2(j”X$documentation ; cabal project optionjŽ2UNträ2auhWNhXhhY]ubj–)rå2}rę2(hBX documentationrē2hCjŚ2hIhJhKjšhM}rč2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ré2hbX documentationrź2…rė2}rģ2(hBUhINhWNhXhhCjå2ubaubj )rķ2}rī2(hBj£hCjŚ2hIhJhKj¤hM}rļ2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rš2hbX: rń2…rņ2}ró2(hBUhINhWNhXhhCjķ2ubaubjŖ)rō2}rõ2(hBXbooleanhCjŚ2hIhJhKj­hM}rö2(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r÷2hbXbooleanrų2…rł2}rś2(hBUhINhWNhXhhCjō2ubaubeubj‡)rū2}rü2(hBX--enable-documentationrż2hCjÕ2hIhJhKjŠhM}rž2(hR]r’2Xcfg-flag---enable-documentationr3ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r3(jw)r3}r3(hBUhCjū2hIhJhKjzhM}r3(hR]hQ]hO]hP]hU]Uentries]r3(j”X,--enable-documentation; cabal project optionj3UNtr3auhWNhXhhY]ubj–)r3}r3(hBjż2hCjū2hIhJhKjšhM}r 3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r 3hbX--enable-documentationr 3…r 3}r 3(hBUhINhWNhXhhCj3ubaubj )r3}r3(hBU hCjū2hIhJhKj¤hM}r3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r3hbX …r3}r3(hBUhINhWNhXhhCj3ubaubeubj‡)r3}r3(hBX--disable-documentationr3hCjÕ2hIhJhKjŠhM}r3(hR]r3X cfg-flag---disable-documentationr3ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r3(jw)r3}r3(hBUhCj3hIhJhKjzhM}r3(hR]hQ]hO]hP]hU]Uentries]r3(j”X---disable-documentation; cabal project optionj3UNtr3auhWNhXhhY]ubj–)r 3}r!3(hBj3hCj3hIhJhKjšhM}r"3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r#3hbX--disable-documentationr$3…r%3}r&3(hBUhINhWNhXhhCj 3ubaubj )r'3}r(3(hBU hCj3hIhJhKj¤hM}r)3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r*3hbX …r+3}r,3(hBUhINhWNhXhhCj'3ubaubeubj³)r-3}r.3(hBUhCjÕ2hIhJhKj¶hM}r/3(hO]hP]hQ]hR]hU]uhWNhXhhY]r03(j¹)r13}r23(hBUhCj-3hIhJhKj¼hM}r33(hO]hP]hQ]hR]hU]uhWNhXhhY]r43jæ)r53}r63(hBUhM}r73(hO]hP]hQ]hR]hU]uhCj13hY]r83(jÄ)r93}r:3(hBX Default valuehCj53hIhJhKjĒhM}r;3(hO]hP]hQ]hR]hU]uhWKhY]r<3hbX Default valuer=3…r>3}r?3(hBUhCj93ubaubjĶ)r@3}rA3(hBUhM}rB3(hO]hP]hQ]hR]hU]uhCj53hY]rC3hu)rD3}rE3(hBXFalsehM}rF3(hO]hP]hQ]hR]hU]uhCj@3hY]rG3hbXFalserH3…rI3}rJ3(hBXFalsehINhWNhXhhCjD3ubahKhyubahKjŻubehKjŽubaubhu)rK3}rL3(hBX)Enables building of Haddock documentationrM3hCj-3hIhJhKhyhM}rN3(hO]hP]hQ]hR]hU]uhWM hXhhY]rO3hbX)Enables building of Haddock documentationrP3…rQ3}rR3(hBjM3hINhWNhXhhCjK3ubaubhu)rS3}rT3(hBXdThe command line variant of this flag is ``--enable-documentation`` and ``--disable-documentation``.hCj-3hIhJhKhyhM}rU3(hO]hP]hQ]hR]hU]uhWM¢hXhhY]rV3(hbX)The command line variant of this flag is rW3…rX3}rY3(hBX)The command line variant of this flag is hINhWNhXhhCjS3ubh›)rZ3}r[3(hBX``--enable-documentation``hM}r\3(hO]hP]hQ]hR]hU]uhCjS3hY]r]3hbX--enable-documentationr^3…r_3}r`3(hBUhCjZ3ubahKh£ubhbX and ra3…rb3}rc3(hBX and hINhWNhXhhCjS3ubh›)rd3}re3(hBX``--disable-documentation``hM}rf3(hO]hP]hQ]hR]hU]uhCjS3hY]rg3hbX--disable-documentationrh3…ri3}rj3(hBUhCjd3ubahKh£ubhbX.…rk3}rl3(hBX.hINhWNhXhhCjS3ubeubhu)rm3}rn3(hBXŌ`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.hCj-3hIhJhKhyhM}ro3(hO]hP]hQ]hR]hU]uhWM„hXhhY]rp3(jƒ)rq3}rr3(hBX`documentation: true`hM}rs3(hO]hP]hQ]hR]hU]uhCjm3hY]rt3hbXdocumentation: trueru3…rv3}rw3(hBUhCjq3ubahKj‹ubhbX does not imply rx3…ry3}rz3(hBX does not imply hINhWNhXhhCjm3ubj[)r{3}r|3(hBX:cfg-field:`haddock-benchmarks`r}3hCjm3hIhJhKj_hM}r~3(UreftypeX cfg-fieldjaˆjbXhaddock-benchmarksU refdomainXcabalr3hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM„hY]r€3h›)r3}r‚3(hBj}3hM}rƒ3(hO]hP]r„3(jlj3Xcabal-cfg-fieldr…3ehQ]hR]hU]uhCj{3hY]r†3hbXhaddock-benchmarksr‡3…rˆ3}r‰3(hBUhCj3ubahKh£ubaubhbX, rŠ3…r‹3}rŒ3(hBX, hINhWNhXhhCjm3ubj[)r3}rŽ3(hBX :cfg-field:`haddock-executables`r3hCjm3hIhJhKj_hM}r3(UreftypeX cfg-fieldjaˆjbXhaddock-executablesU refdomainXcabalr‘3hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM„hY]r’3h›)r“3}r”3(hBj3hM}r•3(hO]hP]r–3(jlj‘3Xcabal-cfg-fieldr—3ehQ]hR]hU]uhCj3hY]r˜3hbXhaddock-executablesr™3…rš3}r›3(hBUhCj“3ubahKh£ubaubhbX, rœ3…r3}rž3(hBX, hINhWNhXhhCjm3ubj[)rŸ3}r 3(hBX:cfg-field:`haddock-internal`r”3hCjm3hIhJhKj_hM}r¢3(UreftypeX cfg-fieldjaˆjbXhaddock-internalU refdomainXcabalr£3hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM„hY]r¤3h›)r„3}r¦3(hBj”3hM}r§3(hO]hP]rØ3(jlj£3Xcabal-cfg-fieldr©3ehQ]hR]hU]uhCjŸ3hY]rŖ3hbXhaddock-internalr«3…r¬3}r­3(hBUhCj„3ubahKh£ubaubhbX or r®3…rÆ3}r°3(hBX or hINhWNhXhhCjm3ubj[)r±3}r²3(hBX:cfg-field:`haddock-tests`r³3hCjm3hIhJhKj_hM}r“3(UreftypeX cfg-fieldjaˆjbX haddock-testsU refdomainXcabalrµ3hR]hQ]U refexplicit‰hO]hP]hU]jdjej NuhWM„hY]r¶3h›)r·3}rø3(hBj³3hM}r¹3(hO]hP]rŗ3(jljµ3Xcabal-cfg-fieldr»3ehQ]hR]hU]uhCj±3hY]r¼3hbX haddock-testsr½3…r¾3}ræ3(hBUhCj·3ubahKh£ubaubhbX1. These need to be enabled separately if desired.rĄ3…rĮ3}rĀ3(hBX1. These need to be enabled separately if desired.hINhWNhXhhCjm3ubeubeubeubjw)rĆ3}rÄ3(hBUhCjÄ2hIhJhKjzhM}rÅ3(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rĘ3}rĒ3(hBUhCjÄ2hIhJhKjhM}rČ3(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÉ3j…jÉ3uhWNhXhhY]rŹ3(j‡)rĖ3}rĢ3(hBXdoc-index-file: templated pathhCjĘ3hIhJhKjŠhM}rĶ3(hR]rĪ3Xcfg-field-doc-index-filerĻ3ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŠ3(jw)rŃ3}rŅ3(hBUhCjĖ3hIhJhKjzhM}rÓ3(hR]hQ]hO]hP]hU]Uentries]rŌ3(j”X%doc-index-file ; cabal project optionjĻ3UNtrÕ3auhWNhXhhY]ubj–)rÖ3}r×3(hBXdoc-index-filerŲ3hCjĖ3hIhJhKjšhM}rŁ3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŚ3hbXdoc-index-filerŪ3…rÜ3}rŻ3(hBUhINhWNhXhhCjÖ3ubaubj )rŽ3}rß3(hBj£hCjĖ3hIhJhKj¤hM}rą3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rį3hbX: rā3…rć3}rä3(hBUhINhWNhXhhCjŽ3ubaubjŖ)rå3}rę3(hBXtemplated pathhCjĖ3hIhJhKj­hM}rē3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rč3hbXtemplated pathré3…rź3}rė3(hBUhINhWNhXhhCjå3ubaubeubj‡)rģ3}rķ3(hBX--doc-index-file=TEMPLATEhCjĘ3hIhJhKjŠhM}rī3(hR]rļ3Xcfg-flag---doc-index-filerš3ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rń3(jw)rņ3}ró3(hBUhCjģ3hIhJhKjzhM}rō3(hR]hQ]hO]hP]hU]Uentries]rõ3(j”X&--doc-index-file; cabal project optionjš3UNtrö3auhWNhXhhY]ubj–)r÷3}rų3(hBX--doc-index-filerł3hCjģ3hIhJhKjšhM}rś3(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rū3hbX--doc-index-filerü3…rż3}rž3(hBUhINhWNhXhhCj÷3ubaubj )r’3}r4(hBX =TEMPLATEhCjģ3hIhJhKj¤hM}r4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r4hbX =TEMPLATEr4…r4}r4(hBUhINhWNhXhhCj’3ubaubeubj³)r4}r4(hBUhCjĘ3hIhJhKj¶hM}r4(hO]hP]hQ]hR]hU]uhWNhXhhY]r 4(hu)r 4}r 4(hBXA central index of Haddock API documentation (template cannot use ``$pkgid``), which should be updated as documentation is built.hCj4hIhJhKhyhM}r 4(hO]hP]hQ]hR]hU]uhWM®hXhhY]r 4(hbXBA central index of Haddock API documentation (template cannot use r4…r4}r4(hBXBA central index of Haddock API documentation (template cannot use hINhWNhXhhCj 4ubh›)r4}r4(hBX ``$pkgid``hM}r4(hO]hP]hQ]hR]hU]uhCj 4hY]r4hbX$pkgidr4…r4}r4(hBUhCj4ubahKh£ubhbX5), which should be updated as documentation is built.r4…r4}r4(hBX5), which should be updated as documentation is built.hINhWNhXhhCj 4ubeubhu)r4}r4(hBXFThe command line variant of this flag is ``--doc-index-file=TEMPLATE``hCj4hIhJhKhyhM}r4(hO]hP]hQ]hR]hU]uhWM±hXhhY]r4(hbX)The command line variant of this flag is r4…r 4}r!4(hBX)The command line variant of this flag is hINhWNhXhhCj4ubh›)r"4}r#4(hBX``--doc-index-file=TEMPLATE``hM}r$4(hO]hP]hQ]hR]hU]uhCj4hY]r%4hbX--doc-index-file=TEMPLATEr&4…r'4}r(4(hBUhCj"4ubahKh£ubeubeubeubhu)r)4}r*4(hBXThe following commands are equivalent to ones that would be passed when running ``setup haddock``. (TODO: Where does the documentation get put.)hCjÄ2hIhJhKhyhM}r+4(hO]hP]hQ]hR]hU]uhWM“hXhhY]r,4(hbXPThe following commands are equivalent to ones that would be passed when running r-4…r.4}r/4(hBXPThe following commands are equivalent to ones that would be passed when running hINhWNhXhhCj)4ubh›)r04}r14(hBX``setup haddock``hM}r24(hO]hP]hQ]hR]hU]uhCj)4hY]r34hbX setup haddockr44…r54}r64(hBUhCj04ubahKh£ubhbX/. (TODO: Where does the documentation get put.)r74…r84}r94(hBX/. (TODO: Where does the documentation get put.)hINhWNhXhhCj)4ubeubjw)r:4}r;4(hBUhCjÄ2hIhJhKjzhM}r<4(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r=4}r>4(hBUhCjÄ2hIhJhKjhM}r?4(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr@4j…j@4uhWNhXhhY]rA4(j‡)rB4}rC4(hBXhaddock-hoogle: booleanhCj=4hIhJhKjŠhM}rD4(hR]rE4Xcfg-field-haddock-hooglerF4ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rG4(jw)rH4}rI4(hBUhCjB4hIhJhKjzhM}rJ4(hR]hQ]hO]hP]hU]Uentries]rK4(j”X%haddock-hoogle ; cabal project optionjF4UNtrL4auhWNhXhhY]ubj–)rM4}rN4(hBXhaddock-hooglerO4hCjB4hIhJhKjšhM}rP4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rQ4hbXhaddock-hooglerR4…rS4}rT4(hBUhINhWNhXhhCjM4ubaubj )rU4}rV4(hBj£hCjB4hIhJhKj¤hM}rW4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rX4hbX: rY4…rZ4}r[4(hBUhINhWNhXhhCjU4ubaubjŖ)r\4}r]4(hBXbooleanhCjB4hIhJhKj­hM}r^4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r_4hbXbooleanr`4…ra4}rb4(hBUhINhWNhXhhCj\4ubaubeubj³)rc4}rd4(hBUhCj=4hIhJhKj¶hM}re4(hO]hP]hQ]hR]hU]uhWNhXhhY]rf4(j¹)rg4}rh4(hBUhCjc4hIhJhKj¼hM}ri4(hO]hP]hQ]hR]hU]uhWNhXhhY]rj4jæ)rk4}rl4(hBUhM}rm4(hO]hP]hQ]hR]hU]uhCjg4hY]rn4(jÄ)ro4}rp4(hBX Default valuehCjk4hIhJhKjĒhM}rq4(hO]hP]hQ]hR]hU]uhWKhY]rr4hbX Default valuers4…rt4}ru4(hBUhCjo4ubaubjĶ)rv4}rw4(hBUhM}rx4(hO]hP]hQ]hR]hU]uhCjk4hY]ry4hu)rz4}r{4(hBXFalsehM}r|4(hO]hP]hQ]hR]hU]uhCjv4hY]r}4hbXFalser~4…r4}r€4(hBXFalsehINhWNhXhhCjz4ubahKhyubahKjŻubehKjŽubaubhu)r4}r‚4(hBX›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.hCjc4hIhJhKhyhM}rƒ4(hO]hP]hQ]hR]hU]uhWM¼hXhhY]r„4(hbX/Generate a text file which can be converted by r…4…r†4}r‡4(hBX/Generate a text file which can be converted by hINhWNhXhhCj4ubji)rˆ4}r‰4(hBXHoogle_UresolvedrŠ4KhCj4hKjrhM}r‹4(UnameXHooglejmXhttp://www.haskell.org/hoogle/rŒ4hR]hQ]hO]hP]hU]uhY]r4hbXHooglerŽ4…r4}r4(hBUhCjˆ4ubaubhbX> into a database for searching. This is equivalent to running r‘4…r’4}r“4(hBX> into a database for searching. This is equivalent to running hINhWNhXhhCj4ubh›)r”4}r•4(hBX ``haddock``hM}r–4(hO]hP]hQ]hR]hU]uhCj4hY]r—4hbXhaddockr˜4…r™4}rš4(hBUhCj”4ubahKh£ubhbX with the r›4…rœ4}r4(hBX with the hINhWNhXhhCj4ubh›)rž4}rŸ4(hBX ``--hoogle``hM}r 4(hO]hP]hQ]hR]hU]uhCj4hY]r”4hbX--hoogler¢4…r£4}r¤4(hBUhCjž4ubahKh£ubhbX flag.r„4…r¦4}r§4(hBX flag.hINhWNhXhhCj4ubeubhu)rØ4}r©4(hBXTThe command line variant of this flag is ``--hoogle`` (for the ``haddock`` command).hCjc4hIhJhKhyhM}rŖ4(hO]hP]hQ]hR]hU]uhWMĄhXhhY]r«4(hbX)The command line variant of this flag is r¬4…r­4}r®4(hBX)The command line variant of this flag is hINhWNhXhhCjØ4ubh›)rÆ4}r°4(hBX ``--hoogle``hM}r±4(hO]hP]hQ]hR]hU]uhCjØ4hY]r²4hbX--hoogler³4…r“4}rµ4(hBUhCjÆ4ubahKh£ubhbX (for the r¶4…r·4}rø4(hBX (for the hINhWNhXhhCjØ4ubh›)r¹4}rŗ4(hBX ``haddock``hM}r»4(hO]hP]hQ]hR]hU]uhCjØ4hY]r¼4hbXhaddockr½4…r¾4}ræ4(hBUhCj¹4ubahKh£ubhbX command).rĄ4…rĮ4}rĀ4(hBX command).hINhWNhXhhCjØ4ubeubeubeubjw)rĆ4}rÄ4(hBUhCjÄ2hIhJhKjzhM}rÅ4(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rĘ4}rĒ4(hBUhCjÄ2hIhJhKjhM}rČ4(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÉ4j…jÉ4uhWNhXhhY]rŹ4(j‡)rĖ4}rĢ4(hBXhaddock-html: booleanhCjĘ4hIhJhKjŠhM}rĶ4(hR]rĪ4Xcfg-field-haddock-htmlrĻ4ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŠ4(jw)rŃ4}rŅ4(hBUhCjĖ4hIhJhKjzhM}rÓ4(hR]hQ]hO]hP]hU]Uentries]rŌ4(j”X#haddock-html ; cabal project optionjĻ4UNtrÕ4auhWNhXhhY]ubj–)rÖ4}r×4(hBX haddock-htmlrŲ4hCjĖ4hIhJhKjšhM}rŁ4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŚ4hbX haddock-htmlrŪ4…rÜ4}rŻ4(hBUhINhWNhXhhCjÖ4ubaubj )rŽ4}rß4(hBj£hCjĖ4hIhJhKj¤hM}rą4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rį4hbX: rā4…rć4}rä4(hBUhINhWNhXhhCjŽ4ubaubjŖ)rå4}rę4(hBXbooleanhCjĖ4hIhJhKj­hM}rē4(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rč4hbXbooleanré4…rź4}rė4(hBUhINhWNhXhhCjå4ubaubeubj³)rģ4}rķ4(hBUhCjĘ4hIhJhKj¶hM}rī4(hO]hP]hQ]hR]hU]uhWNhXhhY]rļ4(j¹)rš4}rń4(hBUhCjģ4hIhJhKj¼hM}rņ4(hO]hP]hQ]hR]hU]uhWNhXhhY]ró4jæ)rō4}rõ4(hBUhM}rö4(hO]hP]hQ]hR]hU]uhCjš4hY]r÷4(jÄ)rų4}rł4(hBX Default valuehCjō4hIhJhKjĒhM}rś4(hO]hP]hQ]hR]hU]uhWKhY]rū4hbX Default valuerü4…rż4}rž4(hBUhCjų4ubaubjĶ)r’4}r5(hBUhM}r5(hO]hP]hQ]hR]hU]uhCjō4hY]r5hu)r5}r5(hBXTruehM}r5(hO]hP]hQ]hR]hU]uhCj’4hY]r5hbXTruer5…r5}r 5(hBXTruehINhWNhXhhCj5ubahKhyubahKjŻubehKjŽubaubhu)r 5}r 5(hBXBuild HTML documentation.r 5hCjģ4hIhJhKhyhM}r 5(hO]hP]hQ]hR]hU]uhWMČhXhhY]r5hbXBuild HTML documentation.r5…r5}r5(hBj 5hINhWNhXhhCj 5ubaubhu)r5}r5(hBXRThe command line variant of this flag is ``--html`` (for the ``haddock`` command).hCjģ4hIhJhKhyhM}r5(hO]hP]hQ]hR]hU]uhWMŹhXhhY]r5(hbX)The command line variant of this flag is r5…r5}r5(hBX)The command line variant of this flag is hINhWNhXhhCj5ubh›)r5}r5(hBX ``--html``hM}r5(hO]hP]hQ]hR]hU]uhCj5hY]r5hbX--htmlr5…r5}r5(hBUhCj5ubahKh£ubhbX (for the r 5…r!5}r"5(hBX (for the hINhWNhXhhCj5ubh›)r#5}r$5(hBX ``haddock``hM}r%5(hO]hP]hQ]hR]hU]uhCj5hY]r&5hbXhaddockr'5…r(5}r)5(hBUhCj#5ubahKh£ubhbX command).r*5…r+5}r,5(hBX command).hINhWNhXhhCj5ubeubeubeubjw)r-5}r.5(hBUhCjÄ2hIhJhKjzhM}r/5(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r05}r15(hBUhCjÄ2hIhJhKjhM}r25(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr35j…j35uhWNhXhhY]r45(j‡)r55}r65(hBX%haddock-html-location: templated pathhCj05hIhJhKjŠhM}r75(hR]r85Xcfg-field-haddock-html-locationr95ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r:5(jw)r;5}r<5(hBUhCj55hIhJhKjzhM}r=5(hR]hQ]hO]hP]hU]Uentries]r>5(j”X,haddock-html-location ; cabal project optionj95UNtr?5auhWNhXhhY]ubj–)r@5}rA5(hBXhaddock-html-locationrB5hCj55hIhJhKjšhM}rC5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rD5hbXhaddock-html-locationrE5…rF5}rG5(hBUhINhWNhXhhCj@5ubaubj )rH5}rI5(hBj£hCj55hIhJhKj¤hM}rJ5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rK5hbX: rL5…rM5}rN5(hBUhINhWNhXhhCjH5ubaubjŖ)rO5}rP5(hBXtemplated pathhCj55hIhJhKj­hM}rQ5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rR5hbXtemplated pathrS5…rT5}rU5(hBUhINhWNhXhhCjO5ubaubeubj³)rV5}rW5(hBUhCj05hIhJhKj¶hM}rX5(hO]hP]hQ]hR]hU]uhWNhXhhY]rY5(hu)rZ5}r[5(hBX: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\5hCjV5hIhJhKhyhM}r]5(hO]hP]hQ]hR]hU]uhWMŠhXhhY]r^5hbX: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_5…r`5}ra5(hBj\5hINhWNhXhhCjZ5ubaubjš)rb5}rc5(hBXQhtml-location: 'http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'hCjV5hIhJhKjhM}rd5(jŸj hR]hQ]hO]hP]hU]uhWMŲhXhhY]re5hbXQhtml-location: 'http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'rf5…rg5}rh5(hBUhCjb5ubaubhu)ri5}rj5(hBX±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``).hCjV5hIhJhKhyhM}rk5(hO]hP]hQ]hR]hU]uhWMŚhXhhY]rl5(hbX¤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. rm5…rn5}ro5(hBX¤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. hINhWNhXhhCji5ubh›)rp5}rq5(hBX ``ghc-pkg``hM}rr5(hO]hP]hQ]hR]hU]uhCji5hY]rs5hbXghc-pkgrt5…ru5}rv5(hBUhCjp5ubahKh£ubhbX).rw5…rx5}ry5(hBX).hINhWNhXhhCji5ubeubhu)rz5}r{5(hBX^The command line variant of this flag is ``--html-location`` (for the ``haddock`` subcommand).hCjV5hIhJhKhyhM}r|5(hO]hP]hQ]hR]hU]uhWMŽhXhhY]r}5(hbX)The command line variant of this flag is r~5…r5}r€5(hBX)The command line variant of this flag is hINhWNhXhhCjz5ubh›)r5}r‚5(hBX``--html-location``hM}rƒ5(hO]hP]hQ]hR]hU]uhCjz5hY]r„5hbX--html-locationr…5…r†5}r‡5(hBUhCj5ubahKh£ubhbX (for the rˆ5…r‰5}rŠ5(hBX (for the hINhWNhXhhCjz5ubh›)r‹5}rŒ5(hBX ``haddock``hM}r5(hO]hP]hQ]hR]hU]uhCjz5hY]rŽ5hbXhaddockr5…r5}r‘5(hBUhCj‹5ubahKh£ubhbX subcommand).r’5…r“5}r”5(hBX subcommand).hINhWNhXhhCjz5ubeubeubeubjw)r•5}r–5(hBUhCjÄ2hIhJhKjzhM}r—5(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r˜5}r™5(hBUhCjÄ2hIhJhKjhM}rš5(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr›5j…j›5uhWNhXhhY]rœ5(j‡)r5}rž5(hBXhaddock-executables: booleanhCj˜5hIhJhKjŠhM}rŸ5(hR]r 5Xcfg-field-haddock-executablesr”5ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r¢5(jw)r£5}r¤5(hBUhCj5hIhJhKjzhM}r„5(hR]hQ]hO]hP]hU]Uentries]r¦5(j”X*haddock-executables ; cabal project optionj”5UNtr§5auhWNhXhhY]ubj–)rØ5}r©5(hBXhaddock-executablesrŖ5hCj5hIhJhKjšhM}r«5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r¬5hbXhaddock-executablesr­5…r®5}rÆ5(hBUhINhWNhXhhCjØ5ubaubj )r°5}r±5(hBj£hCj5hIhJhKj¤hM}r²5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r³5hbX: r“5…rµ5}r¶5(hBUhINhWNhXhhCj°5ubaubjŖ)r·5}rø5(hBXbooleanhCj5hIhJhKj­hM}r¹5(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗ5hbXbooleanr»5…r¼5}r½5(hBUhINhWNhXhhCj·5ubaubeubj³)r¾5}ræ5(hBUhCj˜5hIhJhKj¶hM}rĄ5(hO]hP]hQ]hR]hU]uhWNhXhhY]rĮ5(j¹)rĀ5}rĆ5(hBUhCj¾5hIhJhKj¼hM}rÄ5(hO]hP]hQ]hR]hU]uhWNhXhhY]rÅ5jæ)rĘ5}rĒ5(hBUhM}rČ5(hO]hP]hQ]hR]hU]uhCjĀ5hY]rÉ5(jÄ)rŹ5}rĖ5(hBX Default valuehCjĘ5hIhJhKjĒhM}rĢ5(hO]hP]hQ]hR]hU]uhWKhY]rĶ5hbX Default valuerĪ5…rĻ5}rŠ5(hBUhCjŹ5ubaubjĶ)rŃ5}rŅ5(hBUhM}rÓ5(hO]hP]hQ]hR]hU]uhCjĘ5hY]rŌ5hu)rÕ5}rÖ5(hBXFalsehM}r×5(hO]hP]hQ]hR]hU]uhCjŃ5hY]rŲ5hbXFalserŁ5…rŚ5}rŪ5(hBXFalsehINhWNhXhhCjÕ5ubahKhyubahKjŻubehKjŽubaubhu)rÜ5}rŻ5(hBX'Run haddock on all executable programs.rŽ5hCj¾5hIhJhKhyhM}rß5(hO]hP]hQ]hR]hU]uhWMęhXhhY]rą5hbX'Run haddock on all executable programs.rį5…rā5}rć5(hBjŽ5hINhWNhXhhCjÜ5ubaubhu)rä5}rå5(hBX\The command line variant of this flag is ``--executables`` (for the ``haddock`` subcommand).hCj¾5hIhJhKhyhM}rę5(hO]hP]hQ]hR]hU]uhWMčhXhhY]rē5(hbX)The command line variant of this flag is rč5…ré5}rź5(hBX)The command line variant of this flag is hINhWNhXhhCjä5ubh›)rė5}rģ5(hBX``--executables``hM}rķ5(hO]hP]hQ]hR]hU]uhCjä5hY]rī5hbX --executablesrļ5…rš5}rń5(hBUhCjė5ubahKh£ubhbX (for the rņ5…ró5}rō5(hBX (for the hINhWNhXhhCjä5ubh›)rõ5}rö5(hBX ``haddock``hM}r÷5(hO]hP]hQ]hR]hU]uhCjä5hY]rų5hbXhaddockrł5…rś5}rū5(hBUhCjõ5ubahKh£ubhbX subcommand).rü5…rż5}rž5(hBX subcommand).hINhWNhXhhCjä5ubeubeubeubjw)r’5}r6(hBUhCjÄ2hIhJhKjzhM}r6(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r6}r6(hBUhCjÄ2hIhJhKjhM}r6(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr6j…j6uhWNhXhhY]r6(j‡)r6}r6(hBXhaddock-tests: booleanhCj6hIhJhKjŠhM}r 6(hR]r 6Xcfg-field-haddock-testsr 6ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r 6(jw)r 6}r6(hBUhCj6hIhJhKjzhM}r6(hR]hQ]hO]hP]hU]Uentries]r6(j”X$haddock-tests ; cabal project optionj 6UNtr6auhWNhXhhY]ubj–)r6}r6(hBX haddock-testsr6hCj6hIhJhKjšhM}r6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r6hbX haddock-testsr6…r6}r6(hBUhINhWNhXhhCj6ubaubj )r6}r6(hBj£hCj6hIhJhKj¤hM}r6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r6hbX: r6…r6}r 6(hBUhINhWNhXhhCj6ubaubjŖ)r!6}r"6(hBXbooleanhCj6hIhJhKj­hM}r#6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r$6hbXbooleanr%6…r&6}r'6(hBUhINhWNhXhhCj!6ubaubeubj³)r(6}r)6(hBUhCj6hIhJhKj¶hM}r*6(hO]hP]hQ]hR]hU]uhWNhXhhY]r+6(j¹)r,6}r-6(hBUhCj(6hIhJhKj¼hM}r.6(hO]hP]hQ]hR]hU]uhWNhXhhY]r/6jæ)r06}r16(hBUhM}r26(hO]hP]hQ]hR]hU]uhCj,6hY]r36(jÄ)r46}r56(hBX Default valuehCj06hIhJhKjĒhM}r66(hO]hP]hQ]hR]hU]uhWKhY]r76hbX Default valuer86…r96}r:6(hBUhCj46ubaubjĶ)r;6}r<6(hBUhM}r=6(hO]hP]hQ]hR]hU]uhCj06hY]r>6hu)r?6}r@6(hBXFalsehM}rA6(hO]hP]hQ]hR]hU]uhCj;6hY]rB6hbXFalserC6…rD6}rE6(hBXFalserF6hINhWNhXhhCj?6ubahKhyubahKjŻubehKjŽubaubhu)rG6}rH6(hBXRun haddock on all test suites.rI6hCj(6hIhJhKhyhM}rJ6(hO]hP]hQ]hR]hU]uhWMšhXhhY]rK6hbXRun haddock on all test suites.rL6…rM6}rN6(hBjI6hINhWNhXhhCjG6ubaubhu)rO6}rP6(hBXVThe command line variant of this flag is ``--tests`` (for the ``haddock`` subcommand).hCj(6hIhJhKhyhM}rQ6(hO]hP]hQ]hR]hU]uhWMņhXhhY]rR6(hbX)The command line variant of this flag is rS6…rT6}rU6(hBX)The command line variant of this flag is hINhWNhXhhCjO6ubh›)rV6}rW6(hBX ``--tests``hM}rX6(hO]hP]hQ]hR]hU]uhCjO6hY]rY6hbX--testsrZ6…r[6}r\6(hBUhCjV6ubahKh£ubhbX (for the r]6…r^6}r_6(hBX (for the hINhWNhXhhCjO6ubh›)r`6}ra6(hBX ``haddock``hM}rb6(hO]hP]hQ]hR]hU]uhCjO6hY]rc6hbXhaddockrd6…re6}rf6(hBUhCj`6ubahKh£ubhbX subcommand).rg6…rh6}ri6(hBX subcommand).hINhWNhXhhCjO6ubeubeubeubjw)rj6}rk6(hBUhCjÄ2hIhJhKjzhM}rl6(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rm6}rn6(hBUhCjÄ2hIhJhKjhM}ro6(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrp6j…jp6uhWNhXhhY]rq6(j‡)rr6}rs6(hBXhaddock-benchmarks: booleanhCjm6hIhJhKjŠhM}rt6(hR]ru6Xcfg-field-haddock-benchmarksrv6ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rw6(jw)rx6}ry6(hBUhCjr6hIhJhKjzhM}rz6(hR]hQ]hO]hP]hU]Uentries]r{6(j”X)haddock-benchmarks ; cabal project optionjv6UNtr|6auhWNhXhhY]ubj–)r}6}r~6(hBXhaddock-benchmarksr6hCjr6hIhJhKjšhM}r€6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r6hbXhaddock-benchmarksr‚6…rƒ6}r„6(hBUhINhWNhXhhCj}6ubaubj )r…6}r†6(hBj£hCjr6hIhJhKj¤hM}r‡6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rˆ6hbX: r‰6…rŠ6}r‹6(hBUhINhWNhXhhCj…6ubaubjŖ)rŒ6}r6(hBXbooleanhCjr6hIhJhKj­hM}rŽ6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r6hbXbooleanr6…r‘6}r’6(hBUhINhWNhXhhCjŒ6ubaubeubj³)r“6}r”6(hBUhCjm6hIhJhKj¶hM}r•6(hO]hP]hQ]hR]hU]uhWNhXhhY]r–6(j¹)r—6}r˜6(hBUhCj“6hIhJhKj¼hM}r™6(hO]hP]hQ]hR]hU]uhWNhXhhY]rš6jæ)r›6}rœ6(hBUhM}r6(hO]hP]hQ]hR]hU]uhCj—6hY]rž6(jÄ)rŸ6}r 6(hBX Default valuehCj›6hIhJhKjĒhM}r”6(hO]hP]hQ]hR]hU]uhWKhY]r¢6hbX Default valuer£6…r¤6}r„6(hBUhCjŸ6ubaubjĶ)r¦6}r§6(hBUhM}rØ6(hO]hP]hQ]hR]hU]uhCj›6hY]r©6hu)rŖ6}r«6(hBXFalsehM}r¬6(hO]hP]hQ]hR]hU]uhCj¦6hY]r­6hbXFalser®6…rÆ6}r°6(hBXFalsehINhWNhXhhCjŖ6ubahKhyubahKjŻubehKjŽubaubhu)r±6}r²6(hBXRun haddock on all benchmarks.r³6hCj“6hIhJhKhyhM}r“6(hO]hP]hQ]hR]hU]uhWMśhXhhY]rµ6hbXRun haddock on all benchmarks.r¶6…r·6}rø6(hBj³6hINhWNhXhhCj±6ubaubhu)r¹6}rŗ6(hBX[The command line variant of this flag is ``--benchmarks`` (for the ``haddock`` subcommand).hCj“6hIhJhKhyhM}r»6(hO]hP]hQ]hR]hU]uhWMühXhhY]r¼6(hbX)The command line variant of this flag is r½6…r¾6}ræ6(hBX)The command line variant of this flag is hINhWNhXhhCj¹6ubh›)rĄ6}rĮ6(hBX``--benchmarks``hM}rĀ6(hO]hP]hQ]hR]hU]uhCj¹6hY]rĆ6hbX --benchmarksrÄ6…rÅ6}rĘ6(hBUhCjĄ6ubahKh£ubhbX (for the rĒ6…rČ6}rÉ6(hBX (for the hINhWNhXhhCj¹6ubh›)rŹ6}rĖ6(hBX ``haddock``hM}rĢ6(hO]hP]hQ]hR]hU]uhCj¹6hY]rĶ6hbXhaddockrĪ6…rĻ6}rŠ6(hBUhCjŹ6ubahKh£ubhbX subcommand).rŃ6…rŅ6}rÓ6(hBX subcommand).hINhWNhXhhCj¹6ubeubeubeubjw)rŌ6}rÕ6(hBUhCjÄ2hIhJhKjzhM}rÖ6(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r×6}rŲ6(hBUhCjÄ2hIhJhKjhM}rŁ6(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrŚ6j…jŚ6uhWNhXhhY]rŪ6(j‡)rÜ6}rŻ6(hBXhaddock-all: booleanhCj×6hIhJhKjŠhM}rŽ6(hR]rß6Xcfg-field-haddock-allrą6ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rį6(jw)rā6}rć6(hBUhCjÜ6hIhJhKjzhM}rä6(hR]hQ]hO]hP]hU]Uentries]rå6(j”X"haddock-all ; cabal project optionją6UNtrę6auhWNhXhhY]ubj–)rē6}rč6(hBX haddock-allré6hCjÜ6hIhJhKjšhM}rź6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rė6hbX haddock-allrģ6…rķ6}rī6(hBUhINhWNhXhhCjē6ubaubj )rļ6}rš6(hBj£hCjÜ6hIhJhKj¤hM}rń6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rņ6hbX: ró6…rō6}rõ6(hBUhINhWNhXhhCjļ6ubaubjŖ)rö6}r÷6(hBXbooleanhCjÜ6hIhJhKj­hM}rų6(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rł6hbXbooleanrś6…rū6}rü6(hBUhINhWNhXhhCjö6ubaubeubj³)rż6}rž6(hBUhCj×6hIhJhKj¶hM}r’6(hO]hP]hQ]hR]hU]uhWNhXhhY]r7(j¹)r7}r7(hBUhCjż6hIhJhKj¼hM}r7(hO]hP]hQ]hR]hU]uhWNhXhhY]r7jæ)r7}r7(hBUhM}r7(hO]hP]hQ]hR]hU]uhCj7hY]r7(jÄ)r 7}r 7(hBX Default valuehCj7hIhJhKjĒhM}r 7(hO]hP]hQ]hR]hU]uhWKhY]r 7hbX Default valuer 7…r7}r7(hBUhCj 7ubaubjĶ)r7}r7(hBUhM}r7(hO]hP]hQ]hR]hU]uhCj7hY]r7hu)r7}r7(hBXFalsehM}r7(hO]hP]hQ]hR]hU]uhCj7hY]r7hbXFalser7…r7}r7(hBXFalsehINhWNhXhhCj7ubahKhyubahKjŻubehKjŽubaubhu)r7}r7(hBXRun haddock on all components.r7hCjż6hIhJhKhyhM}r7(hO]hP]hQ]hR]hU]uhWMhXhhY]r7hbXRun haddock on all components.r 7…r!7}r"7(hBj7hINhWNhXhhCj7ubaubhu)r#7}r$7(hBXTThe command line variant of this flag is ``--all`` (for the ``haddock`` subcommand).hCjż6hIhJhKhyhM}r%7(hO]hP]hQ]hR]hU]uhWMhXhhY]r&7(hbX)The command line variant of this flag is r'7…r(7}r)7(hBX)The command line variant of this flag is hINhWNhXhhCj#7ubh›)r*7}r+7(hBX ``--all``hM}r,7(hO]hP]hQ]hR]hU]uhCj#7hY]r-7hbX--allr.7…r/7}r07(hBUhCj*7ubahKh£ubhbX (for the r17…r27}r37(hBX (for the hINhWNhXhhCj#7ubh›)r47}r57(hBX ``haddock``hM}r67(hO]hP]hQ]hR]hU]uhCj#7hY]r77hbXhaddockr87…r97}r:7(hBUhCj47ubahKh£ubhbX subcommand).r;7…r<7}r=7(hBX subcommand).hINhWNhXhhCj#7ubeubeubeubjw)r>7}r?7(hBUhCjÄ2hIhJhKjzhM}r@7(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rA7}rB7(hBUhCjÄ2hIhJhKjhM}rC7(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrD7j…jD7uhWNhXhhY]rE7(j‡)rF7}rG7(hBXhaddock-internal: booleanhCjA7hIhJhKjŠhM}rH7(hR]rI7Xcfg-field-haddock-internalrJ7ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rK7(jw)rL7}rM7(hBUhCjF7hIhJhKjzhM}rN7(hR]hQ]hO]hP]hU]Uentries]rO7(j”X'haddock-internal ; cabal project optionjJ7UNtrP7auhWNhXhhY]ubj–)rQ7}rR7(hBXhaddock-internalrS7hCjF7hIhJhKjšhM}rT7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rU7hbXhaddock-internalrV7…rW7}rX7(hBUhINhWNhXhhCjQ7ubaubj )rY7}rZ7(hBj£hCjF7hIhJhKj¤hM}r[7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r\7hbX: r]7…r^7}r_7(hBUhINhWNhXhhCjY7ubaubjŖ)r`7}ra7(hBXbooleanhCjF7hIhJhKj­hM}rb7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rc7hbXbooleanrd7…re7}rf7(hBUhINhWNhXhhCj`7ubaubeubj³)rg7}rh7(hBUhCjA7hIhJhKj¶hM}ri7(hO]hP]hQ]hR]hU]uhWNhXhhY]rj7(j¹)rk7}rl7(hBUhCjg7hIhJhKj¼hM}rm7(hO]hP]hQ]hR]hU]uhWNhXhhY]rn7jæ)ro7}rp7(hBUhM}rq7(hO]hP]hQ]hR]hU]uhCjk7hY]rr7(jÄ)rs7}rt7(hBX Default valuehCjo7hIhJhKjĒhM}ru7(hO]hP]hQ]hR]hU]uhWKhY]rv7hbX Default valuerw7…rx7}ry7(hBUhCjs7ubaubjĶ)rz7}r{7(hBUhM}r|7(hO]hP]hQ]hR]hU]uhCjo7hY]r}7hu)r~7}r7(hBXFalsehM}r€7(hO]hP]hQ]hR]hU]uhCjz7hY]r7hbXFalser‚7…rƒ7}r„7(hBXFalsehINhWNhXhhCj~7ubahKhyubahKjŻubehKjŽubaubhu)r…7}r†7(hBXIBuild haddock documentation which includes unexposed modules and symbols.r‡7hCjg7hIhJhKhyhM}rˆ7(hO]hP]hQ]hR]hU]uhWMhXhhY]r‰7hbXIBuild haddock documentation which includes unexposed modules and symbols.rŠ7…r‹7}rŒ7(hBj‡7hINhWNhXhhCj…7ubaubhu)r7}rŽ7(hBXYThe command line variant of this flag is ``--internal`` (for the ``haddock`` subcommand).hCjg7hIhJhKhyhM}r7(hO]hP]hQ]hR]hU]uhWMhXhhY]r7(hbX)The command line variant of this flag is r‘7…r’7}r“7(hBX)The command line variant of this flag is hINhWNhXhhCj7ubh›)r”7}r•7(hBX``--internal``hM}r–7(hO]hP]hQ]hR]hU]uhCj7hY]r—7hbX --internalr˜7…r™7}rš7(hBUhCj”7ubahKh£ubhbX (for the r›7…rœ7}r7(hBX (for the hINhWNhXhhCj7ubh›)rž7}rŸ7(hBX ``haddock``hM}r 7(hO]hP]hQ]hR]hU]uhCj7hY]r”7hbXhaddockr¢7…r£7}r¤7(hBUhCjž7ubahKh£ubhbX subcommand).r„7…r¦7}r§7(hBX subcommand).hINhWNhXhhCj7ubeubeubeubjw)rØ7}r©7(hBUhCjÄ2hIhJhKjzhM}rŖ7(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r«7}r¬7(hBUhCjÄ2hIhJhKjhM}r­7(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr®7j…j®7uhWNhXhhY]rÆ7(j‡)r°7}r±7(hBXhaddock-css: pathhCj«7hIhJhKjŠhM}r²7(hR]r³7Xcfg-field-haddock-cssr“7ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rµ7(jw)r¶7}r·7(hBUhCj°7hIhJhKjzhM}rø7(hR]hQ]hO]hP]hU]Uentries]r¹7(j”X"haddock-css ; cabal project optionj“7UNtrŗ7auhWNhXhhY]ubj–)r»7}r¼7(hBX haddock-cssr½7hCj°7hIhJhKjšhM}r¾7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]ræ7hbX haddock-cssrĄ7…rĮ7}rĀ7(hBUhINhWNhXhhCj»7ubaubj )rĆ7}rÄ7(hBj£hCj°7hIhJhKj¤hM}rÅ7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĘ7hbX: rĒ7…rČ7}rÉ7(hBUhINhWNhXhhCjĆ7ubaubjŖ)rŹ7}rĖ7(hBXpathhCj°7hIhJhKj­hM}rĢ7(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĶ7hbXpathrĪ7…rĻ7}rŠ7(hBUhINhWNhXhhCjŹ7ubaubeubj³)rŃ7}rŅ7(hBUhCj«7hIhJhKj¶hM}rÓ7(hO]hP]hQ]hR]hU]uhWNhXhhY]rŌ7(hu)rÕ7}rÖ7(hBXeThe CSS file that should be used to style the generated documentation (overriding haddock's default.)r×7hCjŃ7hIhJhKhyhM}rŲ7(hO]hP]hQ]hR]hU]uhWMhXhhY]rŁ7hbXgThe CSS file that should be used to style the generated documentation (overriding haddockā€™s default.)rŚ7…rŪ7}rÜ7(hBj×7hINhWNhXhhCjÕ7ubaubhu)rŻ7}rŽ7(hBXTThe command line variant of this flag is ``--css`` (for the ``haddock`` subcommand).hCjŃ7hIhJhKhyhM}rß7(hO]hP]hQ]hR]hU]uhWMhXhhY]rą7(hbX)The command line variant of this flag is rį7…rā7}rć7(hBX)The command line variant of this flag is hINhWNhXhhCjŻ7ubh›)rä7}rå7(hBX ``--css``hM}rę7(hO]hP]hQ]hR]hU]uhCjŻ7hY]rē7hbX--cssrč7…ré7}rź7(hBUhCjä7ubahKh£ubhbX (for the rė7…rģ7}rķ7(hBX (for the hINhWNhXhhCjŻ7ubh›)rī7}rļ7(hBX ``haddock``hM}rš7(hO]hP]hQ]hR]hU]uhCjŻ7hY]rń7hbXhaddockrņ7…ró7}rō7(hBUhCjī7ubahKh£ubhbX subcommand).rõ7…rö7}r÷7(hBX subcommand).hINhWNhXhhCjŻ7ubeubeubeubjw)rų7}rł7(hBUhCjÄ2hIhJhKjzhM}rś7(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rū7}rü7(hBUhCjÄ2hIhJhKjhM}rż7(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrž7j…jž7uhWNhXhhY]r’7(j‡)r8}r8(hBX!haddock-hyperlink-source: booleanhCjū7hIhJhKjŠhM}r8(hR]r8X"cfg-field-haddock-hyperlink-sourcer8ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r8(jw)r8}r8(hBUhCj8hIhJhKjzhM}r8(hR]hQ]hO]hP]hU]Uentries]r 8(j”X/haddock-hyperlink-source ; cabal project optionj8UNtr 8auhWNhXhhY]ubj–)r 8}r 8(hBXhaddock-hyperlink-sourcer 8hCj8hIhJhKjšhM}r8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r8hbXhaddock-hyperlink-sourcer8…r8}r8(hBUhINhWNhXhhCj 8ubaubj )r8}r8(hBj£hCj8hIhJhKj¤hM}r8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r8hbX: r8…r8}r8(hBUhINhWNhXhhCj8ubaubjŖ)r8}r8(hBXbooleanhCj8hIhJhKj­hM}r8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r8hbXbooleanr8…r8}r 8(hBUhINhWNhXhhCj8ubaubeubj³)r!8}r"8(hBUhCjū7hIhJhKj¶hM}r#8(hO]hP]hQ]hR]hU]uhWNhXhhY]r$8(j¹)r%8}r&8(hBUhCj!8hIhJhKj¼hM}r'8(hO]hP]hQ]hR]hU]uhWNhXhhY]r(8jæ)r)8}r*8(hBUhM}r+8(hO]hP]hQ]hR]hU]uhCj%8hY]r,8(jÄ)r-8}r.8(hBX Default valuehCj)8hIhJhKjĒhM}r/8(hO]hP]hQ]hR]hU]uhWKhY]r08hbX Default valuer18…r28}r38(hBUhCj-8ubaubjĶ)r48}r58(hBUhM}r68(hO]hP]hQ]hR]hU]uhCj)8hY]r78hu)r88}r98(hBXFalsehM}r:8(hO]hP]hQ]hR]hU]uhCj48hY]r;8hbXFalser<8…r=8}r>8(hBXFalsehINhWNhXhhCj88ubahKhyubahKjŻubehKjŽubaubhu)r?8}r@8(hBX_Generated hyperlinked source code using `HsColour`_, and have Haddock documentation link to it.hCj!8hIhJhKhyhM}rA8(hO]hP]hQ]hR]hU]uhWM"hXhhY]rB8(hbX(Generated hyperlinked source code using rC8…rD8}rE8(hBX(Generated hyperlinked source code using hINhWNhXhhCj?8ubji)rF8}rG8(hBX `HsColour`_jŠ4KhCj?8hKjrhM}rH8(UnameXHsColourjmX+http://www.cs.york.ac.uk/fp/darcs/hscolour/rI8hR]hQ]hO]hP]hU]uhY]rJ8hbXHsColourrK8…rL8}rM8(hBUhCjF8ubaubhbX,, and have Haddock documentation link to it.rN8…rO8}rP8(hBX,, and have Haddock documentation link to it.hINhWNhXhhCj?8ubeubhu)rQ8}rR8(hBXaThe command line variant of this flag is ``--hyperlink-source`` (for the ``haddock`` subcommand).hCj!8hIhJhKhyhM}rS8(hO]hP]hQ]hR]hU]uhWM%hXhhY]rT8(hbX)The command line variant of this flag is rU8…rV8}rW8(hBX)The command line variant of this flag is hINhWNhXhhCjQ8ubh›)rX8}rY8(hBX``--hyperlink-source``hM}rZ8(hO]hP]hQ]hR]hU]uhCjQ8hY]r[8hbX--hyperlink-sourcer\8…r]8}r^8(hBUhCjX8ubahKh£ubhbX (for the r_8…r`8}ra8(hBX (for the hINhWNhXhhCjQ8ubh›)rb8}rc8(hBX ``haddock``hM}rd8(hO]hP]hQ]hR]hU]uhCjQ8hY]re8hbXhaddockrf8…rg8}rh8(hBUhCjb8ubahKh£ubhbX subcommand).ri8…rj8}rk8(hBX subcommand).hINhWNhXhhCjQ8ubeubeubeubjw)rl8}rm8(hBUhCjÄ2hIhJhKjzhM}rn8(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)ro8}rp8(hBUhCjÄ2hIhJhKjhM}rq8(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrr8j…jr8uhWNhXhhY]rs8(j‡)rt8}ru8(hBXhaddock-hscolour-css: pathhCjo8hIhJhKjŠhM}rv8(hR]rw8Xcfg-field-haddock-hscolour-cssrx8ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]ry8(jw)rz8}r{8(hBUhCjt8hIhJhKjzhM}r|8(hR]hQ]hO]hP]hU]Uentries]r}8(j”X+haddock-hscolour-css ; cabal project optionjx8UNtr~8auhWNhXhhY]ubj–)r8}r€8(hBXhaddock-hscolour-cssr8hCjt8hIhJhKjšhM}r‚8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rƒ8hbXhaddock-hscolour-cssr„8…r…8}r†8(hBUhINhWNhXhhCj8ubaubj )r‡8}rˆ8(hBj£hCjt8hIhJhKj¤hM}r‰8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠ8hbX: r‹8…rŒ8}r8(hBUhINhWNhXhhCj‡8ubaubjŖ)rŽ8}r8(hBXpathhCjt8hIhJhKj­hM}r8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‘8hbXpathr’8…r“8}r”8(hBUhINhWNhXhhCjŽ8ubaubeubj³)r•8}r–8(hBUhCjo8hIhJhKj¶hM}r—8(hO]hP]hQ]hR]hU]uhWNhXhhY]r˜8(hu)r™8}rš8(hBXcThe CSS file that should be used to style the generated hyperlinked source code (from `HsColour`_).hCj•8hIhJhKhyhM}r›8(hO]hP]hQ]hR]hU]uhWM+hXhhY]rœ8(hbXVThe CSS file that should be used to style the generated hyperlinked source code (from r8…rž8}rŸ8(hBXVThe CSS file that should be used to style the generated hyperlinked source code (from hINhWNhXhhCj™8ubji)r 8}r”8(hBX `HsColour`_jŠ4KhCj™8hKjrhM}r¢8(UnameXHsColourjmjI8hR]hQ]hO]hP]hU]uhY]r£8hbXHsColourr¤8…r„8}r¦8(hBUhCj 8ubaubhbX).r§8…rØ8}r©8(hBX).hINhWNhXhhCj™8ubeubhu)rŖ8}r«8(hBX]The command line variant of this flag is ``--hscolour-css`` (for the ``haddock`` subcommand).hCj•8hIhJhKhyhM}r¬8(hO]hP]hQ]hR]hU]uhWM.hXhhY]r­8(hbX)The command line variant of this flag is r®8…rÆ8}r°8(hBX)The command line variant of this flag is hINhWNhXhhCjŖ8ubh›)r±8}r²8(hBX``--hscolour-css``hM}r³8(hO]hP]hQ]hR]hU]uhCjŖ8hY]r“8hbX--hscolour-cssrµ8…r¶8}r·8(hBUhCj±8ubahKh£ubhbX (for the rø8…r¹8}rŗ8(hBX (for the hINhWNhXhhCjŖ8ubh›)r»8}r¼8(hBX ``haddock``hM}r½8(hO]hP]hQ]hR]hU]uhCjŖ8hY]r¾8hbXhaddockræ8…rĄ8}rĮ8(hBUhCj»8ubahKh£ubhbX subcommand).rĀ8…rĆ8}rÄ8(hBX subcommand).hINhWNhXhhCjŖ8ubeubeubeubjw)rÅ8}rĘ8(hBUhCjÄ2hIhJhKjzhM}rĒ8(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rČ8}rÉ8(hBUhCjÄ2hIhJhKjhM}rŹ8(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrĖ8j…jĖ8uhWNhXhhY]rĢ8(j‡)rĶ8}rĪ8(hBXhaddock-contents-location: URLhCjČ8hIhJhKjŠhM}rĻ8(hR]rŠ8X#cfg-field-haddock-contents-locationrŃ8ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŅ8(jw)rÓ8}rŌ8(hBUhCjĶ8hIhJhKjzhM}rÕ8(hR]hQ]hO]hP]hU]Uentries]rÖ8(j”X0haddock-contents-location ; cabal project optionjŃ8UNtr×8auhWNhXhhY]ubj–)rŲ8}rŁ8(hBXhaddock-contents-locationrŚ8hCjĶ8hIhJhKjšhM}rŪ8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÜ8hbXhaddock-contents-locationrŻ8…rŽ8}rß8(hBUhINhWNhXhhCjŲ8ubaubj )rą8}rį8(hBj£hCjĶ8hIhJhKj¤hM}rā8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rć8hbX: rä8…rå8}rę8(hBUhINhWNhXhhCją8ubaubjŖ)rē8}rč8(hBXURLhCjĶ8hIhJhKj­hM}ré8(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rź8hbXURLrė8…rģ8}rķ8(hBUhINhWNhXhhCjē8ubaubeubj³)rī8}rļ8(hBUhCjČ8hIhJhKj¶hM}rš8(hO]hP]hQ]hR]hU]uhWNhXhhY]rń8(hu)rņ8}ró8(hBX@A baked-in URL to be used as the location for the contents page.rō8hCjī8hIhJhKhyhM}rõ8(hO]hP]hQ]hR]hU]uhWM4hXhhY]rö8hbX@A baked-in URL to be used as the location for the contents page.r÷8…rų8}rł8(hBjō8hINhWNhXhhCjņ8ubaubhu)rś8}rū8(hBXbThe command line variant of this flag is ``--contents-location`` (for the ``haddock`` subcommand).hCjī8hIhJhKhyhM}rü8(hO]hP]hQ]hR]hU]uhWM6hXhhY]rż8(hbX)The command line variant of this flag is rž8…r’8}r9(hBX)The command line variant of this flag is hINhWNhXhhCjś8ubh›)r9}r9(hBX``--contents-location``hM}r9(hO]hP]hQ]hR]hU]uhCjś8hY]r9hbX--contents-locationr9…r9}r9(hBUhCj9ubahKh£ubhbX (for the r9…r 9}r 9(hBX (for the hINhWNhXhhCjś8ubh›)r 9}r 9(hBX ``haddock``hM}r 9(hO]hP]hQ]hR]hU]uhCjś8hY]r9hbXhaddockr9…r9}r9(hBUhCj 9ubahKh£ubhbX subcommand).r9…r9}r9(hBX subcommand).hINhWNhXhhCjś8ubeubeubeubjw)r9}r9(hBUhCjÄ2hIhJhKjzhM}r9(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r9}r9(hBUhCjÄ2hIhJhKjhM}r9(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr9j…j9uhWNhXhhY]r9(j‡)r9}r9(hBX haddock-keep-temp-files: booleanhCj9hIhJhKjŠhM}r9(hR]r 9X!cfg-field-haddock-keep-temp-filesr!9ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r"9(jw)r#9}r$9(hBUhCj9hIhJhKjzhM}r%9(hR]hQ]hO]hP]hU]Uentries]r&9(j”X.haddock-keep-temp-files ; cabal project optionj!9UNtr'9auhWNhXhhY]ubj–)r(9}r)9(hBXhaddock-keep-temp-filesr*9hCj9hIhJhKjšhM}r+9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r,9hbXhaddock-keep-temp-filesr-9…r.9}r/9(hBUhINhWNhXhhCj(9ubaubj )r09}r19(hBj£hCj9hIhJhKj¤hM}r29(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r39hbX: r49…r59}r69(hBUhINhWNhXhhCj09ubaubjŖ)r79}r89(hBXbooleanhCj9hIhJhKj­hM}r99(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r:9hbXbooleanr;9…r<9}r=9(hBUhINhWNhXhhCj79ubaubeubj³)r>9}r?9(hBUhCj9hIhJhKj¶hM}r@9(hO]hP]hQ]hR]hU]uhWNhXhhY]rA9(hu)rB9}rC9(hBXKeep temporary files.rD9hCj>9hIhJhKhyhM}rE9(hO]hP]hQ]hR]hU]uhWM<hXhhY]rF9hbXKeep temporary files.rG9…rH9}rI9(hBjD9hINhWNhXhhCjB9ubaubhu)rJ9}rK9(hBX`The command line variant of this flag is ``--keep-temp-files`` (for the ``haddock`` subcommand).hCj>9hIhJhKhyhM}rL9(hO]hP]hQ]hR]hU]uhWM>hXhhY]rM9(hbX)The command line variant of this flag is rN9…rO9}rP9(hBX)The command line variant of this flag is hINhWNhXhhCjJ9ubh›)rQ9}rR9(hBX``--keep-temp-files``hM}rS9(hO]hP]hQ]hR]hU]uhCjJ9hY]rT9hbX--keep-temp-filesrU9…rV9}rW9(hBUhCjQ9ubahKh£ubhbX (for the rX9…rY9}rZ9(hBX (for the hINhWNhXhhCjJ9ubh›)r[9}r\9(hBX ``haddock``hM}r]9(hO]hP]hQ]hR]hU]uhCjJ9hY]r^9hbXhaddockr_9…r`9}ra9(hBUhCj[9ubahKh£ubhbX subcommand).rb9…rc9}rd9(hBX subcommand).hINhWNhXhhCjJ9ubeubeubeubeubeubhD)re9}rf9(hBUhCjŖhIhJhKhLhM}rg9(hO]hP]hQ]hR]rh9jć ahU]ri9h auhWMBhXhhY]rj9(h[)rk9}rl9(hBX%Advanced global configuration optionsrm9hCje9hIhJhKh_hM}rn9(hO]hP]hQ]hR]hU]uhWMBhXhhY]ro9hbX%Advanced global configuration optionsrp9…rq9}rr9(hBjm9hINhWNhXhhCjk9ubaubjw)rs9}rt9(hBUhCje9hIhJhKjzhM}ru9(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rv9}rw9(hBUhCje9hIhJhKjhM}rx9(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldry9j…jy9uhWNhXhhY]rz9(j‡)r{9}r|9(hBX5http-transport: curl, wget, powershell, or plain-httphCjv9hIhJhKjŠhM}r}9(hR]r~9Xcfg-field-http-transportr9ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r€9(jw)r9}r‚9(hBUhCj{9hIhJhKjzhM}rƒ9(hR]hQ]hO]hP]hU]Uentries]r„9(j”X%http-transport ; cabal project optionj9UNtr…9auhWNhXhhY]ubj–)r†9}r‡9(hBXhttp-transportrˆ9hCj{9hIhJhKjšhM}r‰9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŠ9hbXhttp-transportr‹9…rŒ9}r9(hBUhINhWNhXhhCj†9ubaubj )rŽ9}r9(hBj£hCj{9hIhJhKj¤hM}r9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‘9hbX: r’9…r“9}r”9(hBUhINhWNhXhhCjŽ9ubaubjŖ)r•9}r–9(hBX%curl, wget, powershell, or plain-httphCj{9hIhJhKj­hM}r—9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r˜9hbX%curl, wget, powershell, or plain-httpr™9…rš9}r›9(hBUhINhWNhXhhCj•9ubaubeubj‡)rœ9}r9(hBX--http-transport=transporthCjv9hIhJhKjŠhM}rž9(hR]rŸ9Xcfg-flag---http-transportr 9ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r”9(jw)r¢9}r£9(hBUhCjœ9hIhJhKjzhM}r¤9(hR]hQ]hO]hP]hU]Uentries]r„9(j”X&--http-transport; cabal project optionj 9UNtr¦9auhWNhXhhY]ubj–)r§9}rØ9(hBX--http-transportr©9hCjœ9hIhJhKjšhM}rŖ9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r«9hbX--http-transportr¬9…r­9}r®9(hBUhINhWNhXhhCj§9ubaubj )rÆ9}r°9(hBX =transporthCjœ9hIhJhKj¤hM}r±9(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r²9hbX =transportr³9…r“9}rµ9(hBUhINhWNhXhhCjÆ9ubaubeubj³)r¶9}r·9(hBUhCjv9hIhJhKj¶hM}rø9(hO]hP]hQ]hR]hU]uhWNhXhhY]r¹9(j¹)rŗ9}r»9(hBUhCj¶9hIhJhKj¼hM}r¼9(hO]hP]hQ]hR]hU]uhWNhXhhY]r½9jæ)r¾9}ræ9(hBUhM}rĄ9(hO]hP]hQ]hR]hU]uhCjŗ9hY]rĮ9(jÄ)rĀ9}rĆ9(hBX Default valuehCj¾9hIhJhKjĒhM}rÄ9(hO]hP]hQ]hR]hU]uhWKhY]rÅ9hbX Default valuerĘ9…rĒ9}rČ9(hBUhCjĀ9ubaubjĶ)rÉ9}rŹ9(hBUhM}rĖ9(hO]hP]hQ]hR]hU]uhCj¾9hY]rĢ9hu)rĶ9}rĪ9(hBXcurlhM}rĻ9(hO]hP]hQ]hR]hU]uhCjÉ9hY]rŠ9h›)rŃ9}rŅ9(hBX``curl``hCjĶ9hIhJhKh£hM}rÓ9(hO]hP]hQ]hR]hU]uhWNhXhhY]rŌ9hbXcurlrÕ9…rÖ9}r×9(hBUhINhWNhXhhCjŃ9ubaubahKhyubahKjŻubehKjŽubaubhu)rŲ9}rŁ9(hBX8Set a transport to be used when making http(s) requests.rŚ9hCj¶9hIhJhKhyhM}rŪ9(hO]hP]hQ]hR]hU]uhWMJhXhhY]rÜ9hbX8Set a transport to be used when making http(s) requests.rŻ9…rŽ9}rß9(hBjŚ9hINhWNhXhhCjŲ9ubaubhu)rą9}rį9(hBXDThe command line variant of this field is ``--http-transport=curl``.hCj¶9hIhJhKhyhM}rā9(hO]hP]hQ]hR]hU]uhWMLhXhhY]rć9(hbX*The command line variant of this field is rä9…rå9}rę9(hBX*The command line variant of this field is hINhWNhXhhCją9ubh›)rē9}rč9(hBX``--http-transport=curl``hM}ré9(hO]hP]hQ]hR]hU]uhCją9hY]rź9hbX--http-transport=curlrė9…rģ9}rķ9(hBUhCjē9ubahKh£ubhbX.…rī9}rļ9(hBX.hINhWNhXhhCją9ubeubeubeubjw)rš9}rń9(hBUhCje9hIhJhKjzhM}rņ9(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)ró9}rō9(hBUhCje9hIhJhKjhM}rõ9(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrö9j…jö9uhWNhXhhY]r÷9(j‡)rų9}rł9(hBXignore-expiry: booleanhCjó9hIhJhKjŠhM}rś9(hR]rū9Xcfg-field-ignore-expiryrü9ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rż9(jw)rž9}r’9(hBUhCjų9hIhJhKjzhM}r:(hR]hQ]hO]hP]hU]Uentries]r:(j”X$ignore-expiry ; cabal project optionjü9UNtr:auhWNhXhhY]ubj–)r:}r:(hBX ignore-expiryr:hCjų9hIhJhKjšhM}r:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r:hbX ignore-expiryr:…r :}r :(hBUhINhWNhXhhCj:ubaubj )r :}r :(hBj£hCjų9hIhJhKj¤hM}r :(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r:hbX: r:…r:}r:(hBUhINhWNhXhhCj :ubaubjŖ)r:}r:(hBXbooleanhCjų9hIhJhKj­hM}r:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r:hbXbooleanr:…r:}r:(hBUhINhWNhXhhCj:ubaubeubj‡)r:}r:(hBX--ignore-expiryr:hCjó9hIhJhKjŠhM}r:(hR]r:Xcfg-flag---ignore-expiryr:ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r:(jw)r :}r!:(hBUhCj:hIhJhKjzhM}r":(hR]hQ]hO]hP]hU]Uentries]r#:(j”X%--ignore-expiry; cabal project optionj:UNtr$:auhWNhXhhY]ubj–)r%:}r&:(hBj:hCj:hIhJhKjšhM}r':(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r(:hbX--ignore-expiryr):…r*:}r+:(hBUhINhWNhXhhCj%:ubaubj )r,:}r-:(hBU hCj:hIhJhKj¤hM}r.:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r/:hbX …r0:}r1:(hBUhINhWNhXhhCj,:ubaubeubj³)r2:}r3:(hBUhCjó9hIhJhKj¶hM}r4:(hO]hP]hQ]hR]hU]uhWNhXhhY]r5:(j¹)r6:}r7:(hBUhCj2:hIhJhKj¼hM}r8:(hO]hP]hQ]hR]hU]uhWNhXhhY]r9:jæ)r::}r;:(hBUhM}r<:(hO]hP]hQ]hR]hU]uhCj6:hY]r=:(jÄ)r>:}r?:(hBX Default valuehCj::hIhJhKjĒhM}r@:(hO]hP]hQ]hR]hU]uhWKhY]rA:hbX Default valuerB:…rC:}rD:(hBUhCj>:ubaubjĶ)rE:}rF:(hBUhM}rG:(hO]hP]hQ]hR]hU]uhCj::hY]rH:hu)rI:}rJ:(hBXFalsehM}rK:(hO]hP]hQ]hR]hU]uhCjE:hY]rL:hbXFalserM:…rN:}rO:(hBXFalsehINhWNhXhhCjI:ubahKhyubahKjŻubehKjŽubaubhu)rP:}rQ:(hBXBIf ``True``, we will ignore expiry dates on metadata from Hackage.hCj2:hIhJhKhyhM}rR:(hO]hP]hQ]hR]hU]uhWMThXhhY]rS:(hbXIf rT:…rU:}rV:(hBXIf hINhWNhXhhCjP:ubh›)rW:}rX:(hBX``True``hM}rY:(hO]hP]hQ]hR]hU]uhCjP:hY]rZ:hbXTruer[:…r\:}r]:(hBUhCjW:ubahKh£ubhbX7, we will ignore expiry dates on metadata from Hackage.r^:…r_:}r`:(hBX7, we will ignore expiry dates on metadata from Hackage.hINhWNhXhhCjP:ubeubhu)ra:}rb:(hBX 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.hCj2:hIhJhKhyhM}rc:(hO]hP]hQ]hR]hU]uhWMVhXhhY]rd:(hbX'In general, you should not set this to re:…rf:}rg:(hBX'In general, you should not set this to hINhWNhXhhCja:ubh›)rh:}ri:(hBX``True``hM}rj:(hO]hP]hQ]hR]hU]uhCja:hY]rk:hbXTruerl:…rm:}rn:(hBUhCjh:ubahKh£ubhbXń 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.ro:…rp:}rq:(hBXń 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.hINhWNhXhhCja:ubeubhu)rr:}rs:(hBX>The command line variant of this field is ``--ignore-expiry``.hCj2:hIhJhKhyhM}rt:(hO]hP]hQ]hR]hU]uhWM\hXhhY]ru:(hbX*The command line variant of this field is rv:…rw:}rx:(hBX*The command line variant of this field is hINhWNhXhhCjr:ubh›)ry:}rz:(hBX``--ignore-expiry``hM}r{:(hO]hP]hQ]hR]hU]uhCjr:hY]r|:hbX--ignore-expiryr}:…r~:}r:(hBUhCjy:ubahKh£ubhbX.…r€:}r:(hBX.hINhWNhXhhCjr:ubeubeubeubjw)r‚:}rƒ:(hBUhCje9hIhJhKjzhM}r„:(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r…:}r†:(hBUhCje9hIhJhKjhM}r‡:(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrˆ:j…jˆ:uhWNhXhhY]r‰:(j‡)rŠ:}r‹:(hBXremote-repo-cache: directoryhCj…:hIhJhKjŠhM}rŒ:(hR]r:Xcfg-field-remote-repo-cacherŽ:ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r:(jw)r:}r‘:(hBUhCjŠ:hIhJhKjzhM}r’:(hR]hQ]hO]hP]hU]Uentries]r“:(j”X(remote-repo-cache ; cabal project optionjŽ:UNtr”:auhWNhXhhY]ubj–)r•:}r–:(hBXremote-repo-cacher—:hCjŠ:hIhJhKjšhM}r˜:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r™:hbXremote-repo-cacherš:…r›:}rœ:(hBUhINhWNhXhhCj•:ubaubj )r:}rž:(hBj£hCjŠ:hIhJhKj¤hM}rŸ:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r :hbX: r”:…r¢:}r£:(hBUhINhWNhXhhCj:ubaubjŖ)r¤:}r„:(hBX directoryhCjŠ:hIhJhKj­hM}r¦:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§:hbX directoryrØ:…r©:}rŖ:(hBUhINhWNhXhhCj¤:ubaubeubj‡)r«:}r¬:(hBX--remote-repo-cache=DIRhCj…:hIhJhKjŠhM}r­:(hR]r®:Xcfg-flag---remote-repo-cacherÆ:ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r°:(jw)r±:}r²:(hBUhCj«:hIhJhKjzhM}r³:(hR]hQ]hO]hP]hU]Uentries]r“:(j”X)--remote-repo-cache; cabal project optionjÆ:UNtrµ:auhWNhXhhY]ubj–)r¶:}r·:(hBX--remote-repo-cacherø:hCj«:hIhJhKjšhM}r¹:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗ:hbX--remote-repo-cacher»:…r¼:}r½:(hBUhINhWNhXhhCj¶:ubaubj )r¾:}ræ:(hBX=DIRhCj«:hIhJhKj¤hM}rĄ:(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĮ:hbX=DIRrĀ:…rĆ:}rÄ:(hBUhINhWNhXhhCj¾:ubaubeubj³)rÅ:}rĘ:(hBUhCj…:hIhJhKj¶hM}rĒ:(hO]hP]hQ]hR]hU]uhWNhXhhY]rČ:(j¹)rÉ:}rŹ:(hBUhCjÅ:hIhJhKj¼hM}rĖ:(hO]hP]hQ]hR]hU]uhWNhXhhY]rĢ:jæ)rĶ:}rĪ:(hBUhM}rĻ:(hO]hP]hQ]hR]hU]uhCjÉ:hY]rŠ:(jÄ)rŃ:}rŅ:(hBX Default valuehCjĶ:hIhJhKjĒhM}rÓ:(hO]hP]hQ]hR]hU]uhWKhY]rŌ:hbX Default valuerÕ:…rÖ:}r×:(hBUhCjŃ:ubaubjĶ)rŲ:}rŁ:(hBUhM}rŚ:(hO]hP]hQ]hR]hU]uhCjĶ:hY]rŪ:hu)rÜ:}rŻ:(hBX~/.cabal/packageshM}rŽ:(hO]hP]hQ]hR]hU]uhCjŲ:hY]rß:h›)rą:}rį:(hBX``~/.cabal/packages``hCjÜ:hIhJhKh£hM}rā:(hO]hP]hQ]hR]hU]uhWNhXhhY]rć:hbX~/.cabal/packagesrä:…rå:}rę:(hBUhINhWNhXhhCją:ubaubahKhyubahKjŻubehKjŽubaubhu)rē:}rč:(hBXp[STRIKEOUT:The location where packages downloaded from remote repositories will be cached.] Not implemented yet.ré:hCjÅ:hIhJhKhyhM}rź:(hO]hP]hQ]hR]hU]uhWMdhXhhY]rė:hbXp[STRIKEOUT:The location where packages downloaded from remote repositories will be cached.] Not implemented yet.rģ:…rķ:}rī:(hBjé:hINhWNhXhhCjē:ubaubhu)rļ:}rš:(hBXEThe command line variant of this flag is ``--remote-repo-cache=DIR``.hCjÅ:hIhJhKhyhM}rń:(hO]hP]hQ]hR]hU]uhWMghXhhY]rņ:(hbX)The command line variant of this flag is ró:…rō:}rõ:(hBX)The command line variant of this flag is hINhWNhXhhCjļ:ubh›)rö:}r÷:(hBX``--remote-repo-cache=DIR``hM}rų:(hO]hP]hQ]hR]hU]uhCjļ:hY]rł:hbX--remote-repo-cache=DIRrś:…rū:}rü:(hBUhCjö:ubahKh£ubhbX.…rż:}rž:(hBX.hINhWNhXhhCjļ:ubeubeubeubjw)r’:}r;(hBUhCje9hIhJhKjzhM}r;(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r;}r;(hBUhCje9hIhJhKjhM}r;(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr;j…j;uhWNhXhhY]r;(j‡)r;}r;(hBXlogs-dir: directoryhCj;hIhJhKjŠhM}r ;(hR]r ;Xcfg-field-logs-dirr ;ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r ;(jw)r ;}r;(hBUhCj;hIhJhKjzhM}r;(hR]hQ]hO]hP]hU]Uentries]r;(j”Xlogs-dir ; cabal project optionj ;UNtr;auhWNhXhhY]ubj–)r;}r;(hBXlogs-dirr;hCj;hIhJhKjšhM}r;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r;hbXlogs-dirr;…r;}r;(hBUhINhWNhXhhCj;ubaubj )r;}r;(hBj£hCj;hIhJhKj¤hM}r;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r;hbX: r;…r;}r ;(hBUhINhWNhXhhCj;ubaubjŖ)r!;}r";(hBX directoryhCj;hIhJhKj­hM}r#;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r$;hbX directoryr%;…r&;}r';(hBUhINhWNhXhhCj!;ubaubeubj‡)r(;}r);(hBX--logs-dir=DIRhCj;hIhJhKjŠhM}r*;(hR]r+;Xcfg-flag---logs-dirr,;ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r-;(jw)r.;}r/;(hBUhCj(;hIhJhKjzhM}r0;(hR]hQ]hO]hP]hU]Uentries]r1;(j”X --logs-dir; cabal project optionj,;UNtr2;auhWNhXhhY]ubj–)r3;}r4;(hBX --logs-dirr5;hCj(;hIhJhKjšhM}r6;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r7;hbX --logs-dirr8;…r9;}r:;(hBUhINhWNhXhhCj3;ubaubj )r;;}r<;(hBX=DIRhCj(;hIhJhKj¤hM}r=;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r>;hbX=DIRr?;…r@;}rA;(hBUhINhWNhXhhCj;;ubaubeubj³)rB;}rC;(hBUhCj;hIhJhKj¶hM}rD;(hO]hP]hQ]hR]hU]uhWNhXhhY]rE;(j¹)rF;}rG;(hBUhCjB;hIhJhKj¼hM}rH;(hO]hP]hQ]hR]hU]uhWNhXhhY]rI;jæ)rJ;}rK;(hBUhM}rL;(hO]hP]hQ]hR]hU]uhCjF;hY]rM;(jÄ)rN;}rO;(hBX Default valuehCjJ;hIhJhKjĒhM}rP;(hO]hP]hQ]hR]hU]uhWKhY]rQ;hbX Default valuerR;…rS;}rT;(hBUhCjN;ubaubjĶ)rU;}rV;(hBUhM}rW;(hO]hP]hQ]hR]hU]uhCjJ;hY]rX;hu)rY;}rZ;(hBX ~/.cabal/logshM}r[;(hO]hP]hQ]hR]hU]uhCjU;hY]r\;h›)r];}r^;(hBX``~/.cabal/logs``hCjY;hIhJhKh£hM}r_;(hO]hP]hQ]hR]hU]uhWNhXhhY]r`;hbX ~/.cabal/logsra;…rb;}rc;(hBUhINhWNhXhhCj];ubaubahKhyubahKjŻubehKjŽubaubhu)rd;}re;(hBXW[STRIKEOUT:The location where build logs for packages are stored.] Not implemented yet.rf;hCjB;hIhJhKhyhM}rg;(hO]hP]hQ]hR]hU]uhWMphXhhY]rh;hbXW[STRIKEOUT:The location where build logs for packages are stored.] Not implemented yet.ri;…rj;}rk;(hBjf;hINhWNhXhhCjd;ubaubhu)rl;}rm;(hBX<The command line variant of this flag is ``--logs-dir=DIR``.hCjB;hIhJhKhyhM}rn;(hO]hP]hQ]hR]hU]uhWMshXhhY]ro;(hbX)The command line variant of this flag is rp;…rq;}rr;(hBX)The command line variant of this flag is hINhWNhXhhCjl;ubh›)rs;}rt;(hBX``--logs-dir=DIR``hM}ru;(hO]hP]hQ]hR]hU]uhCjl;hY]rv;hbX--logs-dir=DIRrw;…rx;}ry;(hBUhCjs;ubahKh£ubhbX.…rz;}r{;(hBX.hINhWNhXhhCjl;ubeubeubeubjw)r|;}r};(hBUhCje9hIhJhKjzhM}r~;(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r;}r€;(hBUhCje9hIhJhKjhM}r;(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr‚;j…j‚;uhWNhXhhY]rƒ;(j‡)r„;}r…;(hBX build-summary: template filepathhCj;hIhJhKjŠhM}r†;(hR]r‡;Xcfg-field-build-summaryrˆ;ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r‰;(jw)rŠ;}r‹;(hBUhCj„;hIhJhKjzhM}rŒ;(hR]hQ]hO]hP]hU]Uentries]r;(j”X$build-summary ; cabal project optionjˆ;UNtrŽ;auhWNhXhhY]ubj–)r;}r;(hBX build-summaryr‘;hCj„;hIhJhKjšhM}r’;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“;hbX build-summaryr”;…r•;}r–;(hBUhINhWNhXhhCj;ubaubj )r—;}r˜;(hBj£hCj„;hIhJhKj¤hM}r™;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rš;hbX: r›;…rœ;}r;(hBUhINhWNhXhhCj—;ubaubjŖ)rž;}rŸ;(hBXtemplate filepathhCj„;hIhJhKj­hM}r ;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r”;hbXtemplate filepathr¢;…r£;}r¤;(hBUhINhWNhXhhCjž;ubaubeubj‡)r„;}r¦;(hBX--build-summary=TEMPLATEhCj;hIhJhKjŠhM}r§;(hR]rØ;Xcfg-flag---build-summaryr©;ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŖ;(jw)r«;}r¬;(hBUhCj„;hIhJhKjzhM}r­;(hR]hQ]hO]hP]hU]Uentries]r®;(j”X%--build-summary; cabal project optionj©;UNtrÆ;auhWNhXhhY]ubj–)r°;}r±;(hBX--build-summaryr²;hCj„;hIhJhKjšhM}r³;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“;hbX--build-summaryrµ;…r¶;}r·;(hBUhINhWNhXhhCj°;ubaubj )rø;}r¹;(hBX =TEMPLATEhCj„;hIhJhKj¤hM}rŗ;(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r»;hbX =TEMPLATEr¼;…r½;}r¾;(hBUhINhWNhXhhCjø;ubaubeubj³)ræ;}rĄ;(hBUhCj;hIhJhKj¶hM}rĮ;(hO]hP]hQ]hR]hU]uhWNhXhhY]rĀ;(j¹)rĆ;}rÄ;(hBUhCjæ;hIhJhKj¼hM}rÅ;(hO]hP]hQ]hR]hU]uhWNhXhhY]rĘ;jæ)rĒ;}rČ;(hBUhM}rÉ;(hO]hP]hQ]hR]hU]uhCjĆ;hY]rŹ;(jÄ)rĖ;}rĢ;(hBX Default valuehCjĒ;hIhJhKjĒhM}rĶ;(hO]hP]hQ]hR]hU]uhWKhY]rĪ;hbX Default valuerĻ;…rŠ;}rŃ;(hBUhCjĖ;ubaubjĶ)rŅ;}rÓ;(hBUhM}rŌ;(hO]hP]hQ]hR]hU]uhCjĒ;hY]rÕ;hu)rÖ;}r×;(hBX~/.cabal/logs/build.loghM}rŲ;(hO]hP]hQ]hR]hU]uhCjŅ;hY]rŁ;h›)rŚ;}rŪ;(hBX``~/.cabal/logs/build.log``hCjÖ;hIhJhKh£hM}rÜ;(hO]hP]hQ]hR]hU]uhWNhXhhY]rŻ;hbX~/.cabal/logs/build.logrŽ;…rß;}rą;(hBUhINhWNhXhhCjŚ;ubaubahKhyubahKjŻubehKjŽubaubhu)rį;}rā;(hBX¦[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.hCjæ;hIhJhKhyhM}rć;(hO]hP]hQ]hR]hU]uhWM{hXhhY]rä;(hbX_[STRIKEOUT:The file to save build summaries. Valid variables which can be used in the path are rå;…rę;}rē;(hBX_[STRIKEOUT:The file to save build summaries. Valid variables which can be used in the path are hINhWNhXhhCjį;ubh›)rč;}ré;(hBX ``$pkgid``hM}rź;(hO]hP]hQ]hR]hU]uhCjį;hY]rė;hbX$pkgidrģ;…rķ;}rī;(hBUhCjč;ubahKh£ubhbX, rļ;…rš;}rń;(hBX, rņ;hINhWNhXhhCjį;ubh›)ró;}rō;(hBX ``$compiler``hM}rõ;(hO]hP]hQ]hR]hU]uhCjį;hY]rö;hbX $compilerr÷;…rų;}rł;(hBUhCjó;ubahKh£ubhbX, rś;…rū;}rü;(hBjņ;hCjį;ubh›)rż;}rž;(hBX``$os``hM}r’;(hO]hP]hQ]hR]hU]uhCjį;hY]r<hbX$osr<…r<}r<(hBUhCjż;ubahKh£ubhbX and r<…r<}r<(hBX and hINhWNhXhhCjį;ubh›)r<}r<(hBX ``$arch``hM}r <(hO]hP]hQ]hR]hU]uhCjį;hY]r <hbX$archr <…r <}r <(hBUhCj<ubahKh£ubhbX.] Not implemented yet.r<…r<}r<(hBX.] Not implemented yet.hINhWNhXhhCjį;ubeubhu)r<}r<(hBXFThe command line variant of this flag is ``--build-summary=TEMPLATE``.hCjæ;hIhJhKhyhM}r<(hO]hP]hQ]hR]hU]uhWMhXhhY]r<(hbX)The command line variant of this flag is r<…r<}r<(hBX)The command line variant of this flag is hINhWNhXhhCj<ubh›)r<}r<(hBX``--build-summary=TEMPLATE``hM}r<(hO]hP]hQ]hR]hU]uhCj<hY]r<hbX--build-summary=TEMPLATEr<…r<}r<(hBUhCj<ubahKh£ubhbX.…r<}r <(hBX.hINhWNhXhhCj<ubeubeubeubjw)r!<}r"<(hBUhCje9hIhJhKjzhM}r#<(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r$<}r%<(hBUhCje9hIhJhKjhM}r&<(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr'<j…j'<uhWNhXhhY]r(<(j‡)r)<}r*<(hBXlocal-repo: directoryhCj$<hIhJhKjŠhM}r+<(hR]r,<Xcfg-field-local-repor-<ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r.<(jw)r/<}r0<(hBUhCj)<hIhJhKjzhM}r1<(hR]hQ]hO]hP]hU]Uentries]r2<(j”X!local-repo ; cabal project optionj-<UNtr3<auhWNhXhhY]ubj–)r4<}r5<(hBX local-repor6<hCj)<hIhJhKjšhM}r7<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r8<hbX local-repor9<…r:<}r;<(hBUhINhWNhXhhCj4<ubaubj )r<<}r=<(hBj£hCj)<hIhJhKj¤hM}r><(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r?<hbX: r@<…rA<}rB<(hBUhINhWNhXhhCj<<ubaubjŖ)rC<}rD<(hBX directoryhCj)<hIhJhKj­hM}rE<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rF<hbX directoryrG<…rH<}rI<(hBUhINhWNhXhhCjC<ubaubeubj‡)rJ<}rK<(hBX--local-repo=DIRhCj$<hIhJhKjŠhM}rL<(hR]rM<Xcfg-flag---local-reporN<ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rO<(jw)rP<}rQ<(hBUhCjJ<hIhJhKjzhM}rR<(hR]hQ]hO]hP]hU]Uentries]rS<(j”X"--local-repo; cabal project optionjN<UNtrT<auhWNhXhhY]ubj–)rU<}rV<(hBX --local-reporW<hCjJ<hIhJhKjšhM}rX<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rY<hbX --local-reporZ<…r[<}r\<(hBUhINhWNhXhhCjU<ubaubj )r]<}r^<(hBX=DIRhCjJ<hIhJhKj¤hM}r_<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r`<hbX=DIRra<…rb<}rc<(hBUhINhWNhXhhCj]<ubaubeubj³)rd<}re<(hBUhCj$<hIhJhKj¶hM}rf<(hO]hP]hQ]hR]hU]uhWNhXhhY]rg<(j¹)rh<}ri<(hBUhCjd<hIhJhKj¼hM}rj<(hO]hP]hQ]hR]hU]uhWNhXhhY]rk<jæ)rl<}rm<(hBUhCjh<hIhJhKjŽhM}rn<(hO]hP]hQ]hR]hU]uhWNhXhhY]ro<(jÄ)rp<}rq<(hBjX2hCjl<hIhJhKjĒhM}rr<(hO]hP]hQ]hR]hU]uhWKhY]rs<hbX Deprecatedrt<…ru<}rv<(hBUhCjp<ubaubjĶ)rw<}rx<(hBUhM}ry<(hO]hP]hQ]hR]hU]uhCjl<hY]rz<hu)r{<}r|<(hBUhM}r}<(hO]hP]hQ]hR]hU]uhCjw<hY]hKhyubahKjŻubeubaubhu)r~<}r<(hBXV[STRIKEOUT:The location of a local repository.] Deprecated. See "Legacy repositories."r€<hCjd<hIhJhKhyhM}r<(hO]hP]hQ]hR]hU]uhWM†hXhhY]r‚<hbXZ[STRIKEOUT:The location of a local repository.] Deprecated. See ā€œLegacy repositories.ā€rƒ<…r„<}r…<(hBj€<hINhWNhXhhCj~<ubaubhu)r†<}r‡<(hBX>The command line variant of this flag is ``--local-repo=DIR``.hCjd<hIhJhKhyhM}rˆ<(hO]hP]hQ]hR]hU]uhWM‰hXhhY]r‰<(hbX)The command line variant of this flag is rŠ<…r‹<}rŒ<(hBX)The command line variant of this flag is hINhWNhXhhCj†<ubh›)r<}rŽ<(hBX``--local-repo=DIR``hM}r<(hO]hP]hQ]hR]hU]uhCj†<hY]r<hbX--local-repo=DIRr‘<…r’<}r“<(hBUhCj<ubahKh£ubhbX.…r”<}r•<(hBX.hINhWNhXhhCj†<ubeubeubeubjw)r–<}r—<(hBUhCje9hIhJhKjzhM}r˜<(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r™<}rš<(hBUhCje9hIhJhKjhM}r›<(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrœ<j…jœ<uhWNhXhhY]r<(j‡)rž<}rŸ<(hBXworld-file: pathhCj™<hIhJhKjŠhM}r <(hR]r”<Xcfg-field-world-filer¢<ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r£<(jw)r¤<}r„<(hBUhCjž<hIhJhKjzhM}r¦<(hR]hQ]hO]hP]hU]Uentries]r§<(j”X!world-file ; cabal project optionj¢<UNtrØ<auhWNhXhhY]ubj–)r©<}rŖ<(hBX world-filer«<hCjž<hIhJhKjšhM}r¬<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r­<hbX world-filer®<…rÆ<}r°<(hBUhINhWNhXhhCj©<ubaubj )r±<}r²<(hBj£hCjž<hIhJhKj¤hM}r³<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r“<hbX: rµ<…r¶<}r·<(hBUhINhWNhXhhCj±<ubaubjŖ)rø<}r¹<(hBXpathhCjž<hIhJhKj­hM}rŗ<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r»<hbXpathr¼<…r½<}r¾<(hBUhINhWNhXhhCjø<ubaubeubj‡)ræ<}rĄ<(hBX--world-file=FILEhCj™<hIhJhKjŠhM}rĮ<(hR]rĀ<Xcfg-flag---world-filerĆ<ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rÄ<(jw)rÅ<}rĘ<(hBUhCjæ<hIhJhKjzhM}rĒ<(hR]hQ]hO]hP]hU]Uentries]rČ<(j”X"--world-file; cabal project optionjĆ<UNtrÉ<auhWNhXhhY]ubj–)rŹ<}rĖ<(hBX --world-filerĢ<hCjæ<hIhJhKjšhM}rĶ<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĪ<hbX --world-filerĻ<…rŠ<}rŃ<(hBUhINhWNhXhhCjŹ<ubaubj )rŅ<}rÓ<(hBX=FILEhCjæ<hIhJhKj¤hM}rŌ<(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÕ<hbX=FILErÖ<…r×<}rŲ<(hBUhINhWNhXhhCjŅ<ubaubeubj³)rŁ<}rŚ<(hBUhCj™<hIhJhKj¶hM}rŪ<(hO]hP]hQ]hR]hU]uhWNhXhhY]rÜ<(j¹)rŻ<}rŽ<(hBUhCjŁ<hIhJhKj¼hM}rß<(hO]hP]hQ]hR]hU]uhWNhXhhY]rą<jæ)rį<}rā<(hBUhCjŻ<hIhJhKjŽhM}rć<(hO]hP]hQ]hR]hU]uhWNhXhhY]rä<(jÄ)rå<}rę<(hBjX2hCjį<hIhJhKjĒhM}rē<(hO]hP]hQ]hR]hU]uhWKhY]rč<hbX Deprecatedré<…rź<}rė<(hBUhCjå<ubaubjĶ)rģ<}rķ<(hBUhM}rī<(hO]hP]hQ]hR]hU]uhCjį<hY]rļ<hu)rš<}rń<(hBUhM}rņ<(hO]hP]hQ]hR]hU]uhCjģ<hY]hKhyubahKjŻubeubaubhu)ró<}rō<(hBX7[STRIKEOUT:The location of the world file.] Deprecated.rõ<hCjŁ<hIhJhKhyhM}rö<(hO]hP]hQ]hR]hU]uhWMhXhhY]r÷<hbX7[STRIKEOUT:The location of the world file.] Deprecated.rų<…rł<}rś<(hBjõ<hINhWNhXhhCjó<ubaubhu)rū<}rü<(hBX?The command line variant of this flag is ``--world-file=FILE``.hCjŁ<hIhJhKhyhM}rż<(hO]hP]hQ]hR]hU]uhWM‘hXhhY]rž<(hbX)The command line variant of this flag is r’<…r=}r=(hBX)The command line variant of this flag is hINhWNhXhhCjū<ubh›)r=}r=(hBX``--world-file=FILE``hM}r=(hO]hP]hQ]hR]hU]uhCjū<hY]r=hbX--world-file=FILEr=…r=}r=(hBUhCj=ubahKh£ubhbX.…r =}r =(hBX.hINhWNhXhhCjū<ubeubeubeubhu)r =}r =(hBX˜Undocumented fields: ``root-cmd``, ``symlink-bindir``, ``build-log``, ``remote-build-reporting``, ``report-planned-failure``, ``one-shot``, ``offline``.hCje9hIhJhKhyhM}r =(hO]hP]hQ]hR]hU]uhWM“hXhhY]r=(hbXUndocumented fields: r=…r=}r=(hBXUndocumented fields: hINhWNhXhhCj =ubh›)r=}r=(hBX ``root-cmd``hM}r=(hO]hP]hQ]hR]hU]uhCj =hY]r=hbXroot-cmdr=…r=}r=(hBUhCj=ubahKh£ubhbX, r=…r=}r=(hBX, r=hINhWNhXhhCj =ubh›)r=}r=(hBX``symlink-bindir``hM}r=(hO]hP]hQ]hR]hU]uhCj =hY]r =hbXsymlink-bindirr!=…r"=}r#=(hBUhCj=ubahKh£ubhbX, r$=…r%=}r&=(hBX, hCj =ubh›)r'=}r(=(hBX ``build-log``hM}r)=(hO]hP]hQ]hR]hU]uhCj =hY]r*=hbX build-logr+=…r,=}r-=(hBUhCj'=ubahKh£ubhbX, r.=…r/=}r0=(hBX, r1=hINhWNhXhhCj =ubh›)r2=}r3=(hBX``remote-build-reporting``hM}r4=(hO]hP]hQ]hR]hU]uhCj =hY]r5=hbXremote-build-reportingr6=…r7=}r8=(hBUhCj2=ubahKh£ubhbX, r9=…r:=}r;=(hBX, hCj =ubh›)r<=}r==(hBX``report-planned-failure``hM}r>=(hO]hP]hQ]hR]hU]uhCj =hY]r?=hbXreport-planned-failurer@=…rA=}rB=(hBUhCj<=ubahKh£ubhbX, rC=…rD=}rE=(hBj=hCj =ubh›)rF=}rG=(hBX ``one-shot``hM}rH=(hO]hP]hQ]hR]hU]uhCj =hY]rI=hbXone-shotrJ=…rK=}rL=(hBUhCjF=ubahKh£ubhbX, rM=…rN=}rO=(hBj1=hCj =ubh›)rP=}rQ=(hBX ``offline``hM}rR=(hO]hP]hQ]hR]hU]uhCj =hY]rS=hbXofflinerT=…rU=}rV=(hBUhCjP=ubahKh£ubhbX.…rW=}rX=(hBX.hINhWNhXhhCj =ubeubhD)rY=}rZ=(hBUhCje9hIhJhKhLhM}r[=(hO]hP]hQ]hR]r\=jē ahU]r]=h%auhWM˜hXhhY]r^=(h[)r_=}r`=(hBXAdvanced solver optionsra=hCjY=hIhJhKh_hM}rb=(hO]hP]hQ]hR]hU]uhWM˜hXhhY]rc=hbXAdvanced solver optionsrd=…re=}rf=(hBja=hINhWNhXhhCj_=ubaubhu)rg=}rh=(hBX&Most users generally won't need these.ri=hCjY=hIhJhKhyhM}rj=(hO]hP]hQ]hR]hU]uhWMšhXhhY]rk=hbX(Most users generally wonā€™t need these.rl=…rm=}rn=(hBji=hINhWNhXhhCjg=ubaubjw)ro=}rp=(hBUhCjY=hIhJhKjzhM}rq=(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rr=}rs=(hBUhCjY=hIhJhKjhM}rt=(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldru=j…ju=uhWNhXhhY]rv=(j‡)rw=}rx=(hBXsolver: modularhCjr=hIhJhKjŠhM}ry=(hR]rz=Xcfg-field-solverr{=ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r|=(jw)r}=}r~=(hBUhCjw=hIhJhKjzhM}r=(hR]hQ]hO]hP]hU]Uentries]r€=(j”Xsolver ; cabal project optionj{=UNtr=auhWNhXhhY]ubj–)r‚=}rƒ=(hBXsolverr„=hCjw=hIhJhKjšhM}r…=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r†=hbXsolverr‡=…rˆ=}r‰=(hBUhINhWNhXhhCj‚=ubaubj )rŠ=}r‹=(hBj£hCjw=hIhJhKj¤hM}rŒ=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r=hbX: rŽ=…r=}r=(hBUhINhWNhXhhCjŠ=ubaubjŖ)r‘=}r’=(hBXmodularhCjw=hIhJhKj­hM}r“=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r”=hbXmodularr•=…r–=}r—=(hBUhINhWNhXhhCj‘=ubaubeubj‡)r˜=}r™=(hBX--solver=modularhCjr=hIhJhKjŠhM}rš=(hR]r›=Xcfg-flag---solverrœ=ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r=(jw)rž=}rŸ=(hBUhCj˜=hIhJhKjzhM}r =(hR]hQ]hO]hP]hU]Uentries]r”=(j”X--solver; cabal project optionjœ=UNtr¢=auhWNhXhhY]ubj–)r£=}r¤=(hBX--solverr„=hCj˜=hIhJhKjšhM}r¦=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§=hbX--solverrØ=…r©=}rŖ=(hBUhINhWNhXhhCj£=ubaubj )r«=}r¬=(hBX=modularhCj˜=hIhJhKj¤hM}r­=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r®=hbX=modularrÆ=…r°=}r±=(hBUhINhWNhXhhCj«=ubaubeubj³)r²=}r³=(hBUhCjr=hIhJhKj¶hM}r“=(hO]hP]hQ]hR]hU]uhWNhXhhY]rµ=(hu)r¶=}r·=(hBXŒThis field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is ``modular``.hCj²=hIhJhKhyhM}rø=(hO]hP]hQ]hR]hU]uhWM hXhhY]r¹=(hbX€This field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is rŗ=…r»=}r¼=(hBX€This field is reserved to allow the specification of alternative dependency solvers. At the moment, the only accepted option is hINhWNhXhhCj¶=ubh›)r½=}r¾=(hBX ``modular``hM}ræ=(hO]hP]hQ]hR]hU]uhCj¶=hY]rĄ=hbXmodularrĮ=…rĀ=}rĆ=(hBUhCj½=ubahKh£ubhbX.…rÄ=}rÅ=(hBX.hINhWNhXhhCj¶=ubeubhu)rĘ=}rĒ=(hBX?The command line variant of this field is ``--solver=modular``.hCj²=hIhJhKhyhM}rČ=(hO]hP]hQ]hR]hU]uhWM¤hXhhY]rÉ=(hbX*The command line variant of this field is rŹ=…rĖ=}rĢ=(hBX*The command line variant of this field is hINhWNhXhhCjĘ=ubh›)rĶ=}rĪ=(hBX``--solver=modular``hM}rĻ=(hO]hP]hQ]hR]hU]uhCjĘ=hY]rŠ=hbX--solver=modularrŃ=…rŅ=}rÓ=(hBUhCjĶ=ubahKh£ubhbX.…rŌ=}rÕ=(hBX.hINhWNhXhhCjĘ=ubeubeubeubjw)rÖ=}r×=(hBUhCjY=hIhJhKjzhM}rŲ=(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rŁ=}rŚ=(hBUhCjY=hIhJhKjhM}rŪ=(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÜ=j…jÜ=uhWNhXhhY]rŻ=(j‡)rŽ=}rß=(hBXmax-backjumps: nathCjŁ=hIhJhKjŠhM}rą=(hR]rį=Xcfg-field-max-backjumpsrā=ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rć=(jw)rä=}rå=(hBUhCjŽ=hIhJhKjzhM}rę=(hR]hQ]hO]hP]hU]Uentries]rē=(j”X$max-backjumps ; cabal project optionjā=UNtrč=auhWNhXhhY]ubj–)ré=}rź=(hBX max-backjumpsrė=hCjŽ=hIhJhKjšhM}rģ=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rķ=hbX max-backjumpsrī=…rļ=}rš=(hBUhINhWNhXhhCjé=ubaubj )rń=}rņ=(hBj£hCjŽ=hIhJhKj¤hM}ró=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rō=hbX: rõ=…rö=}r÷=(hBUhINhWNhXhhCjń=ubaubjŖ)rų=}rł=(hBXnathCjŽ=hIhJhKj­hM}rś=(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rū=hbXnatrü=…rż=}rž=(hBUhINhWNhXhhCjų=ubaubeubj‡)r’=}r>(hBX--max-backjumps=NhCjŁ=hIhJhKjŠhM}r>(hR]r>Xcfg-flag---max-backjumpsr>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r>(jw)r>}r>(hBUhCj’=hIhJhKjzhM}r>(hR]hQ]hO]hP]hU]Uentries]r>(j”X%--max-backjumps; cabal project optionj>UNtr >auhWNhXhhY]ubj–)r >}r >(hBX--max-backjumpsr >hCj’=hIhJhKjšhM}r >(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r>hbX--max-backjumpsr>…r>}r>(hBUhINhWNhXhhCj >ubaubj )r>}r>(hBX=NhCj’=hIhJhKj¤hM}r>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r>hbX=Nr>…r>}r>(hBUhINhWNhXhhCj>ubaubeubj³)r>}r>(hBUhCjŁ=hIhJhKj¶hM}r>(hO]hP]hQ]hR]hU]uhWNhXhhY]r>(j¹)r>}r>(hBUhCj>hIhJhKj¼hM}r>(hO]hP]hQ]hR]hU]uhWNhXhhY]r >jæ)r!>}r">(hBUhM}r#>(hO]hP]hQ]hR]hU]uhCj>hY]r$>(jÄ)r%>}r&>(hBX Default valuehCj!>hIhJhKjĒhM}r'>(hO]hP]hQ]hR]hU]uhWKhY]r(>hbX Default valuer)>…r*>}r+>(hBUhCj%>ubaubjĶ)r,>}r->(hBUhM}r.>(hO]hP]hQ]hR]hU]uhCj!>hY]r/>hu)r0>}r1>(hBX2000hM}r2>(hO]hP]hQ]hR]hU]uhCj,>hY]r3>hbX2000r4>…r5>}r6>(hBX2000hINhWNhXhhCj0>ubahKhyubahKjŻubehKjŽubaubhu)r7>}r8>(hBX¢Maximum number of backjumps (backtracking multiple steps) allowed while solving. Set -1 to allow unlimited backtracking, and 0 to disable backtracking completely.r9>hCj>hIhJhKhyhM}r:>(hO]hP]hQ]hR]hU]uhWM¬hXhhY]r;>hbX¢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>>(hBj9>hINhWNhXhhCj7>ubaubhu)r?>}r@>(hBXCThe command line variant of this field is ``--max-backjumps=2000``.hCj>hIhJhKhyhM}rA>(hO]hP]hQ]hR]hU]uhWM°hXhhY]rB>(hbX*The command line variant of this field is rC>…rD>}rE>(hBX*The command line variant of this field is hINhWNhXhhCj?>ubh›)rF>}rG>(hBX``--max-backjumps=2000``hM}rH>(hO]hP]hQ]hR]hU]uhCj?>hY]rI>hbX--max-backjumps=2000rJ>…rK>}rL>(hBUhCjF>ubahKh£ubhbX.…rM>}rN>(hBX.hINhWNhXhhCj?>ubeubeubeubjw)rO>}rP>(hBUhCjY=hIhJhKjzhM}rQ>(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rR>}rS>(hBUhCjY=hIhJhKjhM}rT>(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrU>j…jU>uhWNhXhhY]rV>(j‡)rW>}rX>(hBXreorder-goals: booleanhCjR>hIhJhKjŠhM}rY>(hR]rZ>Xcfg-field-reorder-goalsr[>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r\>(jw)r]>}r^>(hBUhCjW>hIhJhKjzhM}r_>(hR]hQ]hO]hP]hU]Uentries]r`>(j”X$reorder-goals ; cabal project optionj[>UNtra>auhWNhXhhY]ubj–)rb>}rc>(hBX reorder-goalsrd>hCjW>hIhJhKjšhM}re>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rf>hbX reorder-goalsrg>…rh>}ri>(hBUhINhWNhXhhCjb>ubaubj )rj>}rk>(hBj£hCjW>hIhJhKj¤hM}rl>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rm>hbX: rn>…ro>}rp>(hBUhINhWNhXhhCjj>ubaubjŖ)rq>}rr>(hBXbooleanhCjW>hIhJhKj­hM}rs>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rt>hbXbooleanru>…rv>}rw>(hBUhINhWNhXhhCjq>ubaubeubj‡)rx>}ry>(hBX--reorder-goalsrz>hCjR>hIhJhKjŠhM}r{>(hR]r|>Xcfg-flag---reorder-goalsr}>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r~>(jw)r>}r€>(hBUhCjx>hIhJhKjzhM}r>(hR]hQ]hO]hP]hU]Uentries]r‚>(j”X%--reorder-goals; cabal project optionj}>UNtrƒ>auhWNhXhhY]ubj–)r„>}r…>(hBjz>hCjx>hIhJhKjšhM}r†>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r‡>hbX--reorder-goalsrˆ>…r‰>}rŠ>(hBUhINhWNhXhhCj„>ubaubj )r‹>}rŒ>(hBU hCjx>hIhJhKj¤hM}r>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŽ>hbX …r>}r>(hBUhINhWNhXhhCj‹>ubaubeubj‡)r‘>}r’>(hBX--no-reorder-goalsr“>hCjR>hIhJhKjŠhM}r”>(hR]r•>Xcfg-flag---no-reorder-goalsr–>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r—>(jw)r˜>}r™>(hBUhCj‘>hIhJhKjzhM}rš>(hR]hQ]hO]hP]hU]Uentries]r›>(j”X(--no-reorder-goals; cabal project optionj–>UNtrœ>auhWNhXhhY]ubj–)r>}rž>(hBj“>hCj‘>hIhJhKjšhM}rŸ>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r >hbX--no-reorder-goalsr”>…r¢>}r£>(hBUhINhWNhXhhCj>ubaubj )r¤>}r„>(hBU hCj‘>hIhJhKj¤hM}r¦>(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r§>hbX …rØ>}r©>(hBUhINhWNhXhhCj¤>ubaubeubj³)rŖ>}r«>(hBUhCjR>hIhJhKj¶hM}r¬>(hO]hP]hQ]hR]hU]uhWNhXhhY]r­>(j¹)r®>}rÆ>(hBUhCjŖ>hIhJhKj¼hM}r°>(hO]hP]hQ]hR]hU]uhWNhXhhY]r±>jæ)r²>}r³>(hBUhM}r“>(hO]hP]hQ]hR]hU]uhCj®>hY]rµ>(jÄ)r¶>}r·>(hBX Default valuehCj²>hIhJhKjĒhM}rø>(hO]hP]hQ]hR]hU]uhWKhY]r¹>hbX Default valuerŗ>…r»>}r¼>(hBUhCj¶>ubaubjĶ)r½>}r¾>(hBUhM}ræ>(hO]hP]hQ]hR]hU]uhCj²>hY]rĄ>hu)rĮ>}rĀ>(hBXFalsehM}rĆ>(hO]hP]hQ]hR]hU]uhCj½>hY]rÄ>hbXFalserÅ>…rĘ>}rĒ>(hBXFalserČ>hINhWNhXhhCjĮ>ubahKhyubahKjŻubehKjŽubaubhu)rÉ>}rŹ>(hBXJWhen 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.hCjŖ>hIhJhKhyhM}rĖ>(hO]hP]hQ]hR]hU]uhWM¹hXhhY]rĢ>(hbX*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Ļ>(hBX(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 hINhWNhXhhCjÉ>ubji)rŠ>}rŃ>(hBX#1780hM}rŅ>(UrefuriX,https://github.com/haskell/cabal/issues/1780hR]hQ]hO]hP]hU]Uinternal‰uhCjÉ>hY]rÓ>hbX#1780rŌ>…rÕ>}rÖ>(hBUhCjŠ>ubahKjrubhbX for more commentary.r×>…rŲ>}rŁ>(hBX for more commentary.hINhWNhXhhCjÉ>ubeubhu)rŚ>}rŪ>(hBXCThe command line variant of this field is ``--(no-)reorder-goals``.hCjŖ>hIhJhKhyhM}rÜ>(hO]hP]hQ]hR]hU]uhWMæhXhhY]rŻ>(hbX*The command line variant of this field is rŽ>…rß>}rą>(hBX*The command line variant of this field is hINhWNhXhhCjŚ>ubh›)rį>}rā>(hBX``--(no-)reorder-goals``hM}rć>(hO]hP]hQ]hR]hU]uhCjŚ>hY]rä>hbX--(no-)reorder-goalsrå>…rę>}rē>(hBUhCjį>ubahKh£ubhbX.…rč>}ré>(hBX.hINhWNhXhhCjŚ>ubeubeubeubjw)rź>}rė>(hBUhCjY=hIhJhKjzhM}rģ>(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rķ>}rī>(hBUhCjY=hIhJhKjhM}rļ>(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrš>j…jš>uhWNhXhhY]rń>(j‡)rņ>}ró>(hBXcount-conflicts: booleanhCjķ>hIhJhKjŠhM}rō>(hR]rõ>Xcfg-field-count-conflictsrö>ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r÷>(jw)rų>}rł>(hBUhCjņ>hIhJhKjzhM}rś>(hR]hQ]hO]hP]hU]Uentries]rū>(j”X&count-conflicts ; cabal project optionjö>UNtrü>auhWNhXhhY]ubj–)rż>}rž>(hBXcount-conflictsr’>hCjņ>hIhJhKjšhM}r?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r?hbXcount-conflictsr?…r?}r?(hBUhINhWNhXhhCjż>ubaubj )r?}r?(hBj£hCjņ>hIhJhKj¤hM}r?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r?hbX: r ?…r ?}r ?(hBUhINhWNhXhhCj?ubaubjŖ)r ?}r ?(hBXbooleanhCjņ>hIhJhKj­hM}r?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r?hbXbooleanr?…r?}r?(hBUhINhWNhXhhCj ?ubaubeubj‡)r?}r?(hBX--count-conflictsr?hCjķ>hIhJhKjŠhM}r?(hR]r?Xcfg-flag---count-conflictsr?ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r?(jw)r?}r?(hBUhCj?hIhJhKjzhM}r?(hR]hQ]hO]hP]hU]Uentries]r?(j”X'--count-conflicts; cabal project optionj?UNtr?auhWNhXhhY]ubj–)r?}r ?(hBj?hCj?hIhJhKjšhM}r!?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r"?hbX--count-conflictsr#?…r$?}r%?(hBUhINhWNhXhhCj?ubaubj )r&?}r'?(hBU hCj?hIhJhKj¤hM}r(?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r)?hbX …r*?}r+?(hBUhINhWNhXhhCj&?ubaubeubj‡)r,?}r-?(hBX--no-count-conflictsr.?hCjķ>hIhJhKjŠhM}r/?(hR]r0?Xcfg-flag---no-count-conflictsr1?ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r2?(jw)r3?}r4?(hBUhCj,?hIhJhKjzhM}r5?(hR]hQ]hO]hP]hU]Uentries]r6?(j”X*--no-count-conflicts; cabal project optionj1?UNtr7?auhWNhXhhY]ubj–)r8?}r9?(hBj.?hCj,?hIhJhKjšhM}r:?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r;?hbX--no-count-conflictsr?(hBUhINhWNhXhhCj8?ubaubj )r??}r@?(hBU hCj,?hIhJhKj¤hM}rA?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rB?hbX …rC?}rD?(hBUhINhWNhXhhCj??ubaubeubj³)rE?}rF?(hBUhCjķ>hIhJhKj¶hM}rG?(hO]hP]hQ]hR]hU]uhWNhXhhY]rH?(j¹)rI?}rJ?(hBUhCjE?hIhJhKj¼hM}rK?(hO]hP]hQ]hR]hU]uhWNhXhhY]rL?jæ)rM?}rN?(hBUhM}rO?(hO]hP]hQ]hR]hU]uhCjI?hY]rP?(jÄ)rQ?}rR?(hBX Default valuehCjM?hIhJhKjĒhM}rS?(hO]hP]hQ]hR]hU]uhWKhY]rT?hbX Default valuerU?…rV?}rW?(hBUhCjQ?ubaubjĶ)rX?}rY?(hBUhM}rZ?(hO]hP]hQ]hR]hU]uhCjM?hY]r[?hu)r\?}r]?(hBXTruehM}r^?(hO]hP]hQ]hR]hU]uhCjX?hY]r_?hbXTruer`?…ra?}rb?(hBXTruehINhWNhXhhCj\?ubahKhyubahKjŻubehKjŽubaubhu)rc?}rd?(hBXTTry to speed up solving by preferring goals that are involved in a lot of conflicts.re?hCjE?hIhJhKhyhM}rf?(hO]hP]hQ]hR]hU]uhWMČhXhhY]rg?hbXTTry to speed up solving by preferring goals that are involved in a lot of conflicts.rh?…ri?}rj?(hBje?hINhWNhXhhCjc?ubaubhu)rk?}rl?(hBXEThe command line variant of this field is ``--(no-)count-conflicts``.hCjE?hIhJhKhyhM}rm?(hO]hP]hQ]hR]hU]uhWMĖhXhhY]rn?(hbX*The command line variant of this field is ro?…rp?}rq?(hBX*The command line variant of this field is hINhWNhXhhCjk?ubh›)rr?}rs?(hBX``--(no-)count-conflicts``hM}rt?(hO]hP]hQ]hR]hU]uhCjk?hY]ru?hbX--(no-)count-conflictsrv?…rw?}rx?(hBUhCjr?ubahKh£ubhbX.…ry?}rz?(hBX.hINhWNhXhhCjk?ubeubeubeubjw)r{?}r|?(hBUhCjY=hIhJhKjzhM}r}?(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r~?}r?(hBUhCjY=hIhJhKjhM}r€?(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr?j…j?uhWNhXhhY]r‚?(j‡)rƒ?}r„?(hBXstrong-flags: booleanhCj~?hIhJhKjŠhM}r…?(hR]r†?Xcfg-field-strong-flagsr‡?ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rˆ?(jw)r‰?}rŠ?(hBUhCjƒ?hIhJhKjzhM}r‹?(hR]hQ]hO]hP]hU]Uentries]rŒ?(j”X#strong-flags ; cabal project optionj‡?UNtr?auhWNhXhhY]ubj–)rŽ?}r?(hBX strong-flagsr?hCjƒ?hIhJhKjšhM}r‘?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r’?hbX strong-flagsr“?…r”?}r•?(hBUhINhWNhXhhCjŽ?ubaubj )r–?}r—?(hBj£hCjƒ?hIhJhKj¤hM}r˜?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r™?hbX: rš?…r›?}rœ?(hBUhINhWNhXhhCj–?ubaubjŖ)r?}rž?(hBXbooleanhCjƒ?hIhJhKj­hM}rŸ?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r ?hbXbooleanr”?…r¢?}r£?(hBUhINhWNhXhhCj?ubaubeubj‡)r¤?}r„?(hBX--strong-flagsr¦?hCj~?hIhJhKjŠhM}r§?(hR]rØ?Xcfg-flag---strong-flagsr©?ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŖ?(jw)r«?}r¬?(hBUhCj¤?hIhJhKjzhM}r­?(hR]hQ]hO]hP]hU]Uentries]r®?(j”X$--strong-flags; cabal project optionj©?UNtrÆ?auhWNhXhhY]ubj–)r°?}r±?(hBj¦?hCj¤?hIhJhKjšhM}r²?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r³?hbX--strong-flagsr“?…rµ?}r¶?(hBUhINhWNhXhhCj°?ubaubj )r·?}rø?(hBU hCj¤?hIhJhKj¤hM}r¹?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rŗ?hbX …r»?}r¼?(hBUhINhWNhXhhCj·?ubaubeubj‡)r½?}r¾?(hBX--no-strong-flagsræ?hCj~?hIhJhKjŠhM}rĄ?(hR]rĮ?Xcfg-flag---no-strong-flagsrĀ?ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rĆ?(jw)rÄ?}rÅ?(hBUhCj½?hIhJhKjzhM}rĘ?(hR]hQ]hO]hP]hU]Uentries]rĒ?(j”X'--no-strong-flags; cabal project optionjĀ?UNtrČ?auhWNhXhhY]ubj–)rÉ?}rŹ?(hBjæ?hCj½?hIhJhKjšhM}rĖ?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rĢ?hbX--no-strong-flagsrĶ?…rĪ?}rĻ?(hBUhINhWNhXhhCjÉ?ubaubj )rŠ?}rŃ?(hBU hCj½?hIhJhKj¤hM}rŅ?(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rÓ?hbX …rŌ?}rÕ?(hBUhINhWNhXhhCjŠ?ubaubeubj³)rÖ?}r×?(hBUhCj~?hIhJhKj¶hM}rŲ?(hO]hP]hQ]hR]hU]uhWNhXhhY]rŁ?(j¹)rŚ?}rŪ?(hBUhCjÖ?hIhJhKj¼hM}rÜ?(hO]hP]hQ]hR]hU]uhWNhXhhY]rŻ?jæ)rŽ?}rß?(hBUhM}rą?(hO]hP]hQ]hR]hU]uhCjŚ?hY]rį?(jÄ)rā?}rć?(hBX Default valuehCjŽ?hIhJhKjĒhM}rä?(hO]hP]hQ]hR]hU]uhWKhY]rå?hbX Default valuerę?…rē?}rč?(hBUhCjā?ubaubjĶ)ré?}rź?(hBUhM}rė?(hO]hP]hQ]hR]hU]uhCjŽ?hY]rģ?hu)rķ?}rī?(hBXFalsehM}rļ?(hO]hP]hQ]hR]hU]uhCjé?hY]rš?hbXFalserń?…rņ?}ró?(hBXFalsehINhWNhXhhCjķ?ubahKhyubahKjŻubehKjŽubaubhu)rō?}rõ?(hBX8Do not defer flag choices. (TODO: Better documentation.)rö?hCjÖ?hIhJhKhyhM}r÷?(hO]hP]hQ]hR]hU]uhWMÕhXhhY]rų?hbX8Do not defer flag choices. (TODO: Better documentation.)rł?…rś?}rū?(hBjö?hINhWNhXhhCjō?ubaubhu)rü?}rż?(hBXBThe command line variant of this field is ``--(no-)strong-flags``.hCjÖ?hIhJhKhyhM}rž?(hO]hP]hQ]hR]hU]uhWM×hXhhY]r’?(hbX*The command line variant of this field is r@…r@}r@(hBX*The command line variant of this field is hINhWNhXhhCjü?ubh›)r@}r@(hBX``--(no-)strong-flags``hM}r@(hO]hP]hQ]hR]hU]uhCjü?hY]r@hbX--(no-)strong-flagsr@…r@}r @(hBUhCj@ubahKh£ubhbX.…r @}r @(hBX.hINhWNhXhhCjü?ubeubeubeubjw)r @}r @(hBUhCjY=hIhJhKjzhM}r@(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)r@}r@(hBUhCjY=hIhJhKjhM}r@(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldr@j…j@uhWNhXhhY]r@(j‡)r@}r@(hBX$allow-boot-library-installs: booleanhCj@hIhJhKjŠhM}r@(hR]r@X%cfg-field-allow-boot-library-installsr@ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r@(jw)r@}r@(hBUhCj@hIhJhKjzhM}r@(hR]hQ]hO]hP]hU]Uentries]r@(j”X2allow-boot-library-installs ; cabal project optionj@UNtr@auhWNhXhhY]ubj–)r@}r @(hBXallow-boot-library-installsr!@hCj@hIhJhKjšhM}r"@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r#@hbXallow-boot-library-installsr$@…r%@}r&@(hBUhINhWNhXhhCj@ubaubj )r'@}r(@(hBj£hCj@hIhJhKj¤hM}r)@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r*@hbX: r+@…r,@}r-@(hBUhINhWNhXhhCj'@ubaubjŖ)r.@}r/@(hBXbooleanhCj@hIhJhKj­hM}r0@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r1@hbXbooleanr2@…r3@}r4@(hBUhINhWNhXhhCj.@ubaubeubj‡)r5@}r6@(hBX--allow-boot-library-installsr7@hCj@hIhJhKjŠhM}r8@(hR]r9@X&cfg-flag---allow-boot-library-installsr:@ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]r;@(jw)r<@}r=@(hBUhCj5@hIhJhKjzhM}r>@(hR]hQ]hO]hP]hU]Uentries]r?@(j”X3--allow-boot-library-installs; cabal project optionj:@UNtr@@auhWNhXhhY]ubj–)rA@}rB@(hBj7@hCj5@hIhJhKjšhM}rC@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rD@hbX--allow-boot-library-installsrE@…rF@}rG@(hBUhINhWNhXhhCjA@ubaubj )rH@}rI@(hBU hCj5@hIhJhKj¤hM}rJ@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rK@hbX …rL@}rM@(hBUhINhWNhXhhCjH@ubaubeubj‡)rN@}rO@(hBX --no-allow-boot-library-installsrP@hCj@hIhJhKjŠhM}rQ@(hR]rR@X)cfg-flag---no-allow-boot-library-installsrS@ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rT@(jw)rU@}rV@(hBUhCjN@hIhJhKjzhM}rW@(hR]hQ]hO]hP]hU]Uentries]rX@(j”X6--no-allow-boot-library-installs; cabal project optionjS@UNtrY@auhWNhXhhY]ubj–)rZ@}r[@(hBjP@hCjN@hIhJhKjšhM}r\@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]r]@hbX --no-allow-boot-library-installsr^@…r_@}r`@(hBUhINhWNhXhhCjZ@ubaubj )ra@}rb@(hBU hCjN@hIhJhKj¤hM}rc@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rd@hbX …re@}rf@(hBUhINhWNhXhhCja@ubaubeubj³)rg@}rh@(hBUhCj@hIhJhKj¶hM}ri@(hO]hP]hQ]hR]hU]uhWNhXhhY]rj@(j¹)rk@}rl@(hBUhCjg@hIhJhKj¼hM}rm@(hO]hP]hQ]hR]hU]uhWNhXhhY]rn@jæ)ro@}rp@(hBUhM}rq@(hO]hP]hQ]hR]hU]uhCjk@hY]rr@(jÄ)rs@}rt@(hBX Default valuehCjo@hIhJhKjĒhM}ru@(hO]hP]hQ]hR]hU]uhWKhY]rv@hbX Default valuerw@…rx@}ry@(hBUhCjs@ubaubjĶ)rz@}r{@(hBUhM}r|@(hO]hP]hQ]hR]hU]uhCjo@hY]r}@hu)r~@}r@(hBXFalsehM}r€@(hO]hP]hQ]hR]hU]uhCjz@hY]r@hbXFalser‚@…rƒ@}r„@(hBXFalser…@hINhWNhXhhCj~@ubahKhyubahKjŻubehKjŽubaubhu)r†@}r‡@(hBXÅ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.hCjg@hIhJhKhyhM}rˆ@(hO]hP]hQ]hR]hU]uhWMąhXhhY]r‰@(hbX2By default, the dependency solver doesnā€™t allow rŠ@…r‹@}rŒ@(hBX0By default, the dependency solver doesn't allow hINhWNhXhhCj†@ubh›)r@}rŽ@(hBX``base``hM}r@(hO]hP]hQ]hR]hU]uhCj†@hY]r@hbXbaser‘@…r’@}r“@(hBUhCj@ubahKh£ubhbX, r”@…r•@}r–@(hBX, hINhWNhXhhCj†@ubh›)r—@}r˜@(hBX ``ghc-prim``hM}r™@(hO]hP]hQ]hR]hU]uhCj†@hY]rš@hbXghc-primr›@…rœ@}r@(hBUhCj—@ubahKh£ubhbX, rž@…rŸ@}r @(hBX, r”@hINhWNhXhhCj†@ubh›)r¢@}r£@(hBX``integer-simple``hM}r¤@(hO]hP]hQ]hR]hU]uhCj†@hY]r„@hbXinteger-simpler¦@…r§@}rØ@(hBUhCj¢@ubahKh£ubhbX, r©@…rŖ@}r«@(hBj”@hCj†@ubh›)r¬@}r­@(hBX``integer-gmp``hM}r®@(hO]hP]hQ]hR]hU]uhCj†@hY]rÆ@hbX integer-gmpr°@…r±@}r²@(hBUhCj¬@ubahKh£ubhbX, and r³@…r“@}rµ@(hBX, and hINhWNhXhhCj†@ubh›)r¶@}r·@(hBX``template-haskell``hM}rø@(hO]hP]hQ]hR]hU]uhCj†@hY]r¹@hbXtemplate-haskellrŗ@…r»@}r¼@(hBUhCj¶@ubahKh£ubhbX@ to be installed or upgraded. This flag removes the restriction.r½@…r¾@}ræ@(hBX@ to be installed or upgraded. This flag removes the restriction.hINhWNhXhhCj†@ubeubhu)rĄ@}rĮ@(hBXQThe command line variant of this field is ``--(no-)allow-boot-library-installs``.hCjg@hIhJhKhyhM}rĀ@(hO]hP]hQ]hR]hU]uhWMåhXhhY]rĆ@(hbX*The command line variant of this field is rÄ@…rÅ@}rĘ@(hBX*The command line variant of this field is hINhWNhXhhCjĄ@ubh›)rĒ@}rČ@(hBX&``--(no-)allow-boot-library-installs``hM}rÉ@(hO]hP]hQ]hR]hU]uhCjĄ@hY]rŹ@hbX"--(no-)allow-boot-library-installsrĖ@…rĢ@}rĶ@(hBUhCjĒ@ubahKh£ubhbX.…rĪ@}rĻ@(hBX.hINhWNhXhhCjĄ@ubeubeubeubjw)rŠ@}rŃ@(hBUhCjY=hIhJhKjzhM}rŅ@(hR]hQ]hO]hP]hU]Uentries]uhWNhXhhY]ubj|)rÓ@}rŌ@(hBUhCjY=hIhJhKjhM}rÕ@(j‰j‚XcabalhR]hQ]hO]hP]hU]jƒX cfg-fieldrÖ@j…jÖ@uhWNhXhhY]r×@(j‡)rŲ@}rŁ@(hBXcabal-lib-version: versionhCjÓ@hIhJhKjŠhM}rŚ@(hR]rŪ@Xcfg-field-cabal-lib-versionrÜ@ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rŻ@(jw)rŽ@}rß@(hBUhCjŲ@hIhJhKjzhM}rą@(hR]hQ]hO]hP]hU]Uentries]rį@(j”X(cabal-lib-version ; cabal project optionjÜ@UNtrā@auhWNhXhhY]ubj–)rć@}rä@(hBXcabal-lib-versionrå@hCjŲ@hIhJhKjšhM}rę@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rē@hbXcabal-lib-versionrč@…ré@}rź@(hBUhINhWNhXhhCjć@ubaubj )rė@}rģ@(hBj£hCjŲ@hIhJhKj¤hM}rķ@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rī@hbX: rļ@…rš@}rń@(hBUhINhWNhXhhCjė@ubaubjŖ)rņ@}ró@(hBXversionhCjŲ@hIhJhKj­hM}rō@(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rõ@hbXversionrö@…r÷@}rų@(hBUhINhWNhXhhCjņ@ubaubeubj‡)rł@}rś@(hBX--cabal-lib-version=versionhCjÓ@hIhJhKjŠhM}rū@(hR]rü@Xcfg-flag---cabal-lib-versionrż@ahQ]hO]hP]hU]jŽ‰uhWNhXhhY]rž@(jw)r’@}rA(hBUhCjł@hIhJhKjzhM}rA(hR]hQ]hO]hP]hU]Uentries]rA(j”X)--cabal-lib-version; cabal project optionjż@UNtrAauhWNhXhhY]ubj–)rA}rA(hBX--cabal-lib-versionrAhCjł@hIhJhKjšhM}rA(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rAhbX--cabal-lib-versionr A…r A}r A(hBUhINhWNhXhhCjAubaubj )r A}r A(hBX=versionhCjł@hIhJhKj¤hM}rA(jŸj hR]hQ]hO]hP]hU]uhWNhXhhY]rAhbX=versionrA…rA}rA(hBUhINhWNhXhhCj Aubaubeubj³)rA}rA(hBUhCjÓ@hIhJhKj¶hM}rA(hO]hP]hQ]hR]hU]uhWNhXhhY]rA(hu)rA}rA(hBX(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.)rAhCjAhIhJhKhyhM}rA(hO]hP]hQ]hR]hU]uhWMģhXhhY]rAhbX(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.)rA…rA}rA(hBjAhINhWNhXhhCjAubaubhu)rA}r A(hBXKThe command line variant of this field is ``--cabal-lib-version=1.24.0.1``.hCjAhIhJhKhyhM}r!A(hO]hP]hQ]hR]hU]uhWMņhXhhY]r"A(hbX*The command line variant of this field is r#A…r$A}r%A(hBX*The command line variant of this field is hINhWNhXhhCjAubh›)r&A}r'A(hBX ``--cabal-lib-version=1.24.0.1``hM}r(A(hO]hP]hQ]hR]hU]uhCjAhY]r)AhbX--cabal-lib-version=1.24.0.1r*A…r+A}r,A(hBUhCj&AubahKh£ubhbX.…r-A}r.A(hBX.hINhWNhXhhCjAubeubeubeubcdocutils.nodes comment r/A)r0A}r1A(hBX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyhCjY=hIcdocutils.nodes reprunicode r2AXdoc/references.incr3A…r4A}r5AbhKUcommentr6AhM}r7A(jŸj hR]hQ]hO]hP]hU]uhWKhXhhY]r8AhbX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyr9A…r:A}r;A(hBUhCj0Aubaubj€)rA(hR]hQ]hO]hP]hU]j„jš uhWMūhXhhY]ubj€)r?A}r@A(hBX .. _PVP: http://pvp.haskell.org/hCjY=hIj4Aj‹}rAAh9jBU source_urlr?BNUinput_encodingr@BU utf-8-sigrABU_disable_configrBBNU id_prefixrCBUUcharacter_level_inline_markuprDB‰U tab_widthrEBKUerror_encodingrFBUUTF-8rGBU_sourcerHBhJUgettext_compactrIBˆU generatorrJBNUdump_internalsrKBNU smart_quotesrLBˆU pep_base_urlrMBU https://www.python.org/dev/peps/rNBUsyntax_highlightrOBUlongrPBUinput_encoding_error_handlerrQBj+BUauto_id_prefixrRBUidrSBUdoctitle_xformrTB‰Ustrip_elements_with_classesrUBNU _config_filesrVB]Ufile_insertion_enabledrWBˆU raw_enabledrXBKU dump_settingsrYBNubUsymbol_footnote_startrZBKUidsr[B}r\B(j“7j°7j>j’=jÓ jÄ2jÖ jķ)j? j: jœ=j˜=jŪ jtj7j3j#j #ję j`'jZjVj× jjķjéjå j*jÜ@jŲ@jü9jų9jū1j÷1j¢<jž<ją6jÜ6jęjéjÅjĮj+j'j{$jv$jĶ jÉ j,;j(;j62j12j 9jœ9j%j%jł"jō"j„1j1jÕ jójj™jå(ją(jĆ<jæ<j‹j†j 6j6jź jUAj9j{9j×"jÓ"jÕ#jŠ#jī j™jģ jiAjÖjŅjœ'j—'jń j+,j—&j“&jš#j–#jE,jA,jä j?AjĀ?j½?jE"j@"jn)jj)j¾jŗjF4jB4jŁ jdAjŽ:jŠ:jXjTjŻ jø%j jjQ%jL%jØj¤j:@j5@jx0jt0j–>j‘>jā jļ!j{jwj…jˆjŠ jŖjÆ:j«:j3jū2j¼#j·#j& j! jęjājÆ.j«.hjhfj”$j$j(j(jŹjÅjš j?AjPjLj*"j&"jrjnjf!ja!jLjHj@+j<+j×/jŅ/j95j55jōjšj ;j;j4j0jš3jģ3jø&j“&jŽ jajj jŌ jejŽjŠj)*j$*j>j:j¢ jž jŠhEj@j@jD!j@!ją jKAj-<j)<j”5j5jŲ j_Ajé j/1j!9j9jš/jė/jó%jļ%jˆ;j„;jĆ(jæ(jż@jł@jŚ jnAjmjij¦j¢jŒ)j‡)jŅ%jĪ%jS@jN@j*j*jš0j•0jā=jŽ=jß jZAjĻ3jĖ3jÖjŅjž(jł(j«j§j~jzj:j:jpjljåjįjT-jP-j~jyj[>jW>jü jījk1jf1j8j8jY$jU$ju-jq-j©?j¤?jµj±jx8jt8j³0j®0j;/j6/jĮ+j½+jSjOj8%j3%jT/jO/jė j jŃ8jĶ8jć je9jķ jPAjB*j=*j—j’jį jj?j?j2j2jŃ jJjŅ jö jrjmj©*j„*jg,jb,j7(j2(jyjujQjMj€,j{,j$j jz'jv'j +jœ+jī jź j1?j,?jµ/j±/jĻ4jĖ4j j jŹ*jĘ*j¬ jØ j÷jójč j1 jv6jr6jö>jņ>jI1jE1jČjÄja+j]+jĢjČjJ7jF7jŽ.jŠ.jµ'j°'j_j[jŽ2jŚ2j3j3j\jXj©;j„;jē jY=j}>jx>j "j"jjˆj/j/j‡?jƒ?jP(jK(j{=jw=jš j• j j hThGjļ j<j©j„jÜ jFAjN<jJ<uUsubstitution_namesr]B}r^BhKhXhM}r_B(hO]hR]hQ]UsourcehJhP]hU]uU footnotesr`B]raBUrefidsrbB}rcB(jš ]rdBj