€cdocutils.nodes document q)q}q(U nametypesq}q(Xcmdoption-setup-configure--cidqˆX2cmdoption-setup-configure--enable-library-for-ghciqˆXsetup-unregisterqˆXcmdoption-setup-configure--ghcq ˆXsandboxes: advanced usageq NXcmdoption-setup-test--human-logq ˆX setup-cleanq ˆX setup-haddockq ˆX%cmdoption-setup-configure--libexecdirqˆX"cmdoption-setup-build--prog-optionqˆX!cmdoption-setup-test--test-optionqˆX!cmdoption-setup-configure--globalqˆXcmdoption-setup-hscolour--cssqˆXsecure local repositoriesqNX2cmdoption-setup-configure--disable-library-vanillaqˆX building and installing packagesqNX cmdoption-setup-unregister--userqˆXcreating a binary packageqNX3cmdoption-setup-configure--enable-library-profilingqˆXsandboxes: basic usageqNX3cmdoption-setup-configure--disable-library-for-ghciqˆXmiscellaneous optionsqNX"cmdoption-setup-test--test-optionsqˆX%cmdoption-setup-configure--constraintqˆX,cmdoption-setup-configure--enable-split-objsqˆXcmdoption-setup-clean-sqˆX setup-buildq ˆXbuilding test suitesq!NXsetup registerq"NX+cmdoption-setup-configure--enable-profilingq#ˆX(cmdoption-setup-configure--with-compilerq$ˆX&building and installing a user packageq%NX&cmdoption-setup-configure--with-hc-pkgq&ˆX*cmdoption-setup-configure--extra-lib-dirs[q'ˆXcmdoption-setup-sdist--snapshotq(ˆX!cmdoption-setup-test--machine-logq)ˆX.cmdoption-setup-configure--default-user-configq*ˆX!cmdoption-setup-configure--libdirq+ˆX&cmdoption-setup-configure--dependency[q,ˆX(cmdoption-setup-configure--libexecsubdirq-ˆXlegacy repositoriesq.NX!cmdoption-setup-haddock--internalq/ˆX!cmdoption-setup-configure--bindirq0ˆX$cmdoption-setup-configure--dynlibdirq1ˆX"cmdoption-setup-configure--htmldirq2ˆX"cmdoption-setup-configure--datadirq3ˆX)cmdoption-setup-configure--program-prefixq4ˆX)path variables in the simple build systemq5NXcmdoption-setup-haddock--hoogleq6ˆX'cmdoption-setup-configure--allow-newer[q7ˆX4cmdoption-setup-configure--disable-library-profilingq8ˆXrepository specificationq9NXprefix-independenceq:NXhscolourq;ˆX setup-installq<ˆXcmdoption-setup-hq=ˆXprograms used for buildingq>NX&cmdoption-setup-unregister--gen-scriptq?ˆX setup-sdistq@ˆXcmdoption-setup-configure--uhcqAˆX paths in the simple build systemqBNX setup installqCNX/cmdoption-setup-configure--disable-optimizationqDˆX)cmdoption-setup-configure--disable-sharedqEˆXcmdoption-setup-haddock--cssqFˆXcmdoption-setup-copy--destdirqGˆX%cmdoption-setup-configure--preferenceqHˆXcmdoption-setup-test--builddirqIˆX4cmdoption-setup-configure--library-profiling-detail[qJˆXpvpqKˆX"cmdoption-setup-test--show-detailsqLˆXalexqMˆXcmdoption-setup-configure--userqNˆX configurationqONX6cmdoption-setup-configure--enable-executable-strippingqPˆXcpphsqQˆX.cmdoption-setup-configure--extra-include-dirs[qRˆX%cmdoption-setup-haddock--hscolour-cssqSˆX5cmdoption-setup-configure--disable-executable-dynamicqTˆX setup testqUNX*cmdoption-setup-configure--enable-coverageqVˆX)cmdoption-setup-register--gen-pkg-config[qWˆX"cmdoption-setup-unregister--globalqXˆXoverviewqYNX,cmdoption-setup-configure--disable-profilingqZˆXsetup-registerq[ˆXinstallation pathsq\NXcmdoption-setup-install--globalq]ˆXhaskellq^ˆX%cmdoption-setup-configure--datasubdirq_ˆXhoogleq`ˆXcmdoption-setup-configure--ipidqaˆX%cmdoption-setup-configure--package-dbqbˆX+cmdoption-setup-configure--configure-optionqcˆX1cmdoption-setup-configure--enable-library-vanillaqdˆX,cmdoption-setup-configure--profiling-detail[qeˆXusing secure repositoriesqfNX%cmdoption-setup-clean--save-configureqgˆX&cmdoption-setup-configure--prog-optionqhˆXcmdoption-setup-install--userqiˆXdeveloping with sandboxesqjNXhappyqkˆX/cmdoption-setup-configure--enable-optimization[qlˆX(building and installing a system packageqmNXcmdoption-setup-register--userqnˆX cmdoption-setup-configure--flagsqoˆX#cmdoption-setup-build--prog-optionsqpˆX!cmdoption-setup-register--inplaceqqˆX%cmdoption-setup-hscolour--executablesqrˆXsetup-configureqsˆX'cmdoption-setup-configure--prog-optionsqtˆXcmdoption-setup-configure--lhcquˆX%cmdoption-setup-configure--sysconfdirqvˆX+cmdoption-setup-configure--disable-coverageqwˆX$cmdoption-setup-configure--libsubdirqxˆXhaddockqyˆX&cmdoption-setup-haddock--html-locationqzˆX4cmdoption-setup-configure--enable-executable-dynamicq{ˆXsetup hscolourq|NX installing packages from hackageq}NX'cmdoption-setup-configure--allow-older[q~ˆXcmdoption-setup-configure--jhcqˆX)cmdoption-setup-haddock--hyperlink-sourceq€ˆXsetup configureqNX$cmdoption-setup-register--gen-scriptq‚ˆXpackage versioning policyqƒˆX cmdoption-setup-register--globalq„ˆX(cmdoption-setup-configure--enable-sharedq…ˆX setup copyq†NXsetup unregisterq‡NX!cmdoption-setup-configure--docdirqˆˆX)cmdoption-setup-configure--program-suffixq‰ˆX.cmdoption-setup-configure--exact-configurationqŠˆX$cmdoption-setup-configure--with-progq‹ˆXcmdoption-setup--helpqŒˆX setup haddockqNX7cmdoption-setup-configure--disable-executable-strippingqŽˆX setup cleanqNXsetup-hscolourqˆX!cmdoption-setup-configure--prefixq‘ˆXinstalling-packagesq’ˆX$cmdoption-setup-haddock--executablesq“ˆXcontrolling flag assignmentsq”NX'cmdoption-setup-configure--enable-testsq•ˆX(cmdoption-setup-configure--disable-testsq–ˆX setup buildq—NX-cmdoption-setup-configure--disable-split-objsq˜ˆXcmdoption-setup-test-arg-Giveq™ˆX0cmdoption-setup-configure--extra-framework-dirs[qšˆX setup sdistq›NX setup-copyqœˆXcmdoption-setup--verboseqˆXcmdoption-setup-configure-fqžˆXhackageqŸˆuUsubstitution_defsq }q¡Uparse_messagesq¢]q£Ucurrent_sourceq¤NU decorationq¥NUautofootnote_startq¦KUnameidsq§}q¨(hUcmdoption-setup-configure-cidq©hU1cmdoption-setup-configure-enable-library-for-ghciqªhUsetup-unregisterq«h Ucmdoption-setup-configure-ghcq¬h Usandboxes-advanced-usageq­h Ucmdoption-setup-test-human-logq®h U setup-cleanq¯h U setup-haddockq°hU$cmdoption-setup-configure-libexecdirq±hU"cmdoption-setup-build-prog-optionsq²hU cmdoption-setup-test-test-optionq³hU cmdoption-setup-configure-globalq´hUcmdoption-setup-hscolour-cssqµhUsecure-local-repositoriesq¶hU1cmdoption-setup-configure-disable-library-vanillaq·hU building-and-installing-packagesq¸hUcmdoption-setup-unregister-userq¹hUcreating-a-binary-packageqºhU2cmdoption-setup-configure-enable-library-profilingq»hUsandboxes-basic-usageq¼hU2cmdoption-setup-configure-disable-library-for-ghciq½hUmiscellaneous-optionsq¾hU!cmdoption-setup-test-test-optionsq¿hU$cmdoption-setup-configure-constraintqÀhU+cmdoption-setup-configure-enable-split-objsqÁhU$cmdoption-setup-clean-save-configureqÂh U setup-buildqÃh!Ubuilding-test-suitesqÄh"Uid7qÅh#U*cmdoption-setup-configure-enable-profilingqÆh$U'cmdoption-setup-configure-with-compilerqÇh%U&building-and-installing-a-user-packageqÈh&U%cmdoption-setup-configure-with-hc-pkgqÉh'U(cmdoption-setup-configure-extra-lib-dirsqÊh(Ucmdoption-setup-sdist-snapshotqËh)U cmdoption-setup-test-machine-logqÌh*U-cmdoption-setup-configure-default-user-configqÍh+U cmdoption-setup-configure-libdirqÎh,U$cmdoption-setup-configure-dependencyqÏh-U'cmdoption-setup-configure-libexecsubdirqÐh.Ulegacy-repositoriesqÑh/U cmdoption-setup-haddock-internalqÒh0U cmdoption-setup-configure-bindirqÓh1U#cmdoption-setup-configure-dynlibdirqÔh2U!cmdoption-setup-configure-htmldirqÕh3U!cmdoption-setup-configure-datadirqÖh4U(cmdoption-setup-configure-program-prefixq×h5U)path-variables-in-the-simple-build-systemqØh6Ucmdoption-setup-haddock-hoogleqÙh7U%cmdoption-setup-configure-allow-newerqÚh8U3cmdoption-setup-configure-disable-library-profilingqÛh9Urepository-specificationqÜh:Uprefix-independenceqÝh;UhscolourqÞhUprograms-used-for-buildingqáh?U%cmdoption-setup-unregister-gen-scriptqâh@U setup-sdistqãhAh¬hBU paths-in-the-simple-build-systemqähCUid5qåhDU.cmdoption-setup-configure-disable-optimizationqæhEU(cmdoption-setup-configure-disable-sharedqçhFUcmdoption-setup-haddock-cssqèhGUcmdoption-setup-copy-destdirqéhHU$cmdoption-setup-configure-preferenceqêhIUcmdoption-setup-test-builddirqëhJU2cmdoption-setup-configure-library-profiling-detailqìhKUpvpqíhLU!cmdoption-setup-test-show-detailsqîhMUalexqïhNUcmdoption-setup-configure-userqðhOU configurationqñhPU5cmdoption-setup-configure-enable-executable-strippingqòhQUcpphsqóhRU,cmdoption-setup-configure-extra-include-dirsqôhSU$cmdoption-setup-haddock-hscolour-cssqõhTU4cmdoption-setup-configure-disable-executable-dynamicqöhUU setup-testq÷hVU)cmdoption-setup-configure-enable-coverageqøhWU'cmdoption-setup-register-gen-pkg-configqùhXU!cmdoption-setup-unregister-globalqúhYUoverviewqûhZU+cmdoption-setup-configure-disable-profilingqüh[Usetup-registerqýh\Uinstallation-pathsqþh]Ucmdoption-setup-install-globalqÿh^Uhaskellrh_U$cmdoption-setup-configure-datasubdirrh`UhooglerhaUcmdoption-setup-configure-ipidrhbU$cmdoption-setup-configure-package-dbrhcU*cmdoption-setup-configure-configure-optionrhdU0cmdoption-setup-configure-enable-library-vanillarheU*cmdoption-setup-configure-profiling-detailrhfUusing-secure-repositoriesrhghÂhhU%cmdoption-setup-configure-prog-optionr hiUcmdoption-setup-install-userr hjUdeveloping-with-sandboxesr hkUhappyr hlU-cmdoption-setup-configure-enable-optimizationr hmU(building-and-installing-a-system-packagerhnUcmdoption-setup-register-userrhoUcmdoption-setup-configure-flagsrhph²hqU cmdoption-setup-register-inplacerhrU$cmdoption-setup-hscolour-executablesrhsUsetup-configurerhtU&cmdoption-setup-configure-prog-optionsrhuh¬hvU$cmdoption-setup-configure-sysconfdirrhwU*cmdoption-setup-configure-disable-coveragerhxU#cmdoption-setup-configure-libsubdirrhyUhaddockrhzU%cmdoption-setup-haddock-html-locationrh{U3cmdoption-setup-configure-enable-executable-dynamicrh|Uid4rh}U installing-packages-from-hackagerh~hÚhh¬h€U(cmdoption-setup-haddock-hyperlink-sourcerhUid1rh‚U#cmdoption-setup-register-gen-scriptrhƒUpackage-versioning-policyr h„Ucmdoption-setup-register-globalr!h…U'cmdoption-setup-configure-enable-sharedr"h†Uid6r#h‡Uid8r$hˆU cmdoption-setup-configure-docdirr%h‰U(cmdoption-setup-configure-program-suffixr&hŠU-cmdoption-setup-configure-exact-configurationr'h‹U#cmdoption-setup-configure-with-progr(hŒhàhUid3r)hŽU6cmdoption-setup-configure-disable-executable-strippingr*hUid9r+hUsetup-hscolourr,h‘U cmdoption-setup-configure-prefixr-h’Uinstalling-packagesr.h“U#cmdoption-setup-haddock-executablesr/h”Ucontrolling-flag-assignmentsr0h•U&cmdoption-setup-configure-enable-testsr1h–U'cmdoption-setup-configure-disable-testsr2h—Uid2r3h˜U,cmdoption-setup-configure-disable-split-objsr4h™Ucmdoption-setup-test-arg-giver5hšU.cmdoption-setup-configure-extra-framework-dirsr6h›Uid10r7hœU setup-copyr8hUcmdoption-setup-verboser9hžUcmdoption-setup-configure-fr:hŸUhackager;uUchildrenr<]r=(cdocutils.nodes section r>)r?}r@(U rawsourcerAUUparentrBhUsourcerCXE/home/refold/code/haskell/cabal-2.0/Cabal/doc/installing-packages.rstrDUtagnamerEUsectionrFU attributesrG}rH(UdupnamesrI]UclassesrJ]UbackrefsrK]UidsrL]rMhñaUnamesrN]rOhOauUlinerPKUdocumentrQhj<]rR(cdocutils.nodes title rS)rT}rU(jAX ConfigurationrVjBj?jCjDjEUtitlerWjG}rX(jI]jJ]jK]jL]jN]ujPKjQhj<]rYcdocutils.nodes Text rZX Configurationr[…r\}r](jAjVjCNjPNjQhjBjTubaubcsphinx.addnodes highlightlang r^)r_}r`(jAUjBj?jCjDjEU highlightlangrajG}rb(UlangXcabalUlinenothresholdI9223372036854775807 jL]jK]jI]jJ]jN]ujPKjQhj<]ubj>)rc}rd(jAUjBj?jCjDjEjFjG}re(jI]jJ]jK]jL]rfhûajN]rghYaujPKjQhj<]rh(jS)ri}rj(jAXOverviewrkjBjcjCjDjEjWjG}rl(jI]jJ]jK]jL]jN]ujPKjQhj<]rmjZXOverviewrn…ro}rp(jAjkjCNjPNjQhjBjiubaubcdocutils.nodes paragraph rq)rr}rs(jAXüThe global configuration file for ``cabal-install`` is ``~/.cabal/config``. If you do not have this file, ``cabal`` will create it for you on the first call to ``cabal update``. Alternatively, you can explicitly ask ``cabal`` to create it for you usingjBjcjCjDjEU paragraphrtjG}ru(jI]jJ]jK]jL]jN]ujPK jQhj<]rv(jZX"The global configuration file for rw…rx}ry(jAX"The global configuration file for jCNjPNjQhjBjrubcdocutils.nodes literal rz)r{}r|(jAX``cabal-install``jG}r}(jI]jJ]jK]jL]jN]ujBjrj<]r~jZX cabal-installr…r€}r(jAUjBj{ubajEUliteralr‚ubjZX is rƒ…r„}r…(jAX is jCNjPNjQhjBjrubjz)r†}r‡(jAX``~/.cabal/config``jG}rˆ(jI]jJ]jK]jL]jN]ujBjrj<]r‰jZX~/.cabal/configrŠ…r‹}rŒ(jAUjBj†ubajEj‚ubjZX . If you do not have this file, r…rŽ}r(jAX . If you do not have this file, jCNjPNjQhjBjrubjz)r}r‘(jAX ``cabal``jG}r’(jI]jJ]jK]jL]jN]ujBjrj<]r“jZXcabalr”…r•}r–(jAUjBjubajEj‚ubjZX- will create it for you on the first call to r—…r˜}r™(jAX- will create it for you on the first call to jCNjPNjQhjBjrubjz)rš}r›(jAX``cabal update``jG}rœ(jI]jJ]jK]jL]jN]ujBjrj<]rjZX cabal updaterž…rŸ}r (jAUjBjšubajEj‚ubjZX(. Alternatively, you can explicitly ask r¡…r¢}r£(jAX(. Alternatively, you can explicitly ask jCNjPNjQhjBjrubjz)r¤}r¥(jAX ``cabal``jG}r¦(jI]jJ]jK]jL]jN]ujBjrj<]r§jZXcabalr¨…r©}rª(jAUjBj¤ubajEj‚ubjZX to create it for you usingr«…r¬}r­(jAX to create it for you usingjCNjPNjQhjBjrubeubcdocutils.nodes literal_block r®)r¯}r°(jAX$ cabal user-config updatejBjcjCjDjEU literal_blockr±jG}r²(Ulinenosr³‰Ulanguager´XconsoleU xml:spacerµUpreserver¶jL]jK]jI]Uhighlight_argsr·}jJ]jN]ujPKjQhj<]r¸jZX$ cabal user-config updater¹…rº}r»(jAUjBj¯ubaubjq)r¼}r½(jAXDMost of the options in this configuration file are also available as command line arguments, and the corresponding documentation can be used to lookup their meaning. The created configuration file only specifies values for a handful of options. Most options are left at their default value, which it documents; for instance,r¾jBjcjCjDjEjtjG}r¿(jI]jJ]jK]jL]jN]ujPKjQhj<]rÀjZXDMost of the options in this configuration file are also available as command line arguments, and the corresponding documentation can be used to lookup their meaning. The created configuration file only specifies values for a handful of options. Most options are left at their default value, which it documents; for instance,rÁ…rÂ}rÃ(jAj¾jCNjPNjQhjBj¼ubaubj®)rÄ}rÅ(jAX-- executable-stripping: TruejBjcjCjDjEj±jG}rÆ(jµj¶jL]jK]jI]jJ]jN]ujPKjQhj<]rÇjZX-- executable-stripping: TruerÈ…rÉ}rÊ(jAUjBjÄubaubjq)rË}rÌ(jAXmeans that the configuration file currently does not specify a value for the ``executable-stripping`` option (the line is commented out), and that the default is ``True``; if you wanted to disable stripping of executables by default, you would change this line tojBjcjCjDjEjtjG}rÍ(jI]jJ]jK]jL]jN]ujPKjQhj<]rÎ(jZXMmeans that the configuration file currently does not specify a value for the rÏ…rÐ}rÑ(jAXMmeans that the configuration file currently does not specify a value for the jCNjPNjQhjBjËubjz)rÒ}rÓ(jAX``executable-stripping``jG}rÔ(jI]jJ]jK]jL]jN]ujBjËj<]rÕjZXexecutable-strippingrÖ…r×}rØ(jAUjBjÒubajEj‚ubjZX= option (the line is commented out), and that the default is rÙ…rÚ}rÛ(jAX= option (the line is commented out), and that the default is jCNjPNjQhjBjËubjz)rÜ}rÝ(jAX``True``jG}rÞ(jI]jJ]jK]jL]jN]ujBjËj<]rßjZXTruerà…rá}râ(jAUjBjÜubajEj‚ubjZX]; if you wanted to disable stripping of executables by default, you would change this line torã…rä}rå(jAX]; if you wanted to disable stripping of executables by default, you would change this line tojCNjPNjQhjBjËubeubj®)ræ}rç(jAXexecutable-stripping: FalsejBjcjCjDjEj±jG}rè(jµj¶jL]jK]jI]jJ]jN]ujPK#jQhj<]réjZXexecutable-stripping: Falserê…rë}rì(jAUjBjæubaubjq)rí}rî(jAXtYou can also use ``cabal user-config update`` to migrate configuration files created by older versions of ``cabal``.jBjcjCjDjEjtjG}rï(jI]jJ]jK]jL]jN]ujPK%jQhj<]rð(jZXYou can also use rñ…rò}ró(jAXYou can also use jCNjPNjQhjBjíubjz)rô}rõ(jAX``cabal user-config update``jG}rö(jI]jJ]jK]jL]jN]ujBjíj<]r÷jZXcabal user-config updaterø…rù}rú(jAUjBjôubajEj‚ubjZX= to migrate configuration files created by older versions of rû…rü}rý(jAX= to migrate configuration files created by older versions of jCNjPNjQhjBjíubjz)rþ}rÿ(jAX ``cabal``jG}r(jI]jJ]jK]jL]jN]ujBjíj<]rjZXcabalr…r}r(jAUjBjþubajEj‚ubjZX.…r}r(jAX.jCNjPNjQhjBjíubeubeubj>)r}r(jAUjBj?jCjDjEjFjG}r (jI]jJ]jK]jL]r hÜajN]r h9aujPK)jQhj<]r (jS)r }r(jAXRepository specificationrjBjjCjDjEjWjG}r(jI]jJ]jK]jL]jN]ujPK)jQhj<]rjZXRepository specificationr…r}r(jAjjCNjPNjQhjBj ubaubjq)r}r(jAX»An important part of the configuration if the specification of the repository. When ``cabal`` creates a default config file, it configures the repository to be the central Hackage server:jBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPK+jQhj<]r(jZXTAn important part of the configuration if the specification of the repository. When r…r}r(jAXTAn important part of the configuration if the specification of the repository. When jCNjPNjQhjBjubjz)r}r(jAX ``cabal``jG}r(jI]jJ]jK]jL]jN]ujBjj<]rjZXcabalr …r!}r"(jAUjBjubajEj‚ubjZX^ creates a default config file, it configures the repository to be the central Hackage server:r#…r$}r%(jAX^ creates a default config file, it configures the repository to be the central Hackage server:jCNjPNjQhjBjubeubj®)r&}r'(jAXArepository hackage.haskell.org url: http://hackage.haskell.org/jBjjCjDjEj±jG}r((jµj¶jL]jK]jI]jJ]jN]ujPK1jQhj<]r)jZXArepository hackage.haskell.org url: http://hackage.haskell.org/r*…r+}r,(jAUjBj&ubaubjq)r-}r.(jAX¦The name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under ``~/.cabal/packages/hackage.haskell.org`` (or whatever name you specify; you can change the prefix by changing the value of ``remote-repo-cache``). If you want, you can configure multiple repositories, and ``cabal`` will combine them and be able to download packages from any of them.jBjjCjDjEjtjG}r/(jI]jJ]jK]jL]jN]ujPK4jQhj<]r0(jZXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under r1…r2}r3(jAXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under jCNjPNjQhjBj-ubjz)r4}r5(jAX)``~/.cabal/packages/hackage.haskell.org``jG}r6(jI]jJ]jK]jL]jN]ujBj-j<]r7jZX%~/.cabal/packages/hackage.haskell.orgr8…r9}r:(jAUjBj4ubajEj‚ubjZXS (or whatever name you specify; you can change the prefix by changing the value of r;…r<}r=(jAXS (or whatever name you specify; you can change the prefix by changing the value of jCNjPNjQhjBj-ubjz)r>}r?(jAX``remote-repo-cache``jG}r@(jI]jJ]jK]jL]jN]ujBj-j<]rAjZXremote-repo-cacherB…rC}rD(jAUjBj>ubajEj‚ubjZX=). If you want, you can configure multiple repositories, and rE…rF}rG(jAX=). If you want, you can configure multiple repositories, and jCNjPNjQhjBj-ubjz)rH}rI(jAX ``cabal``jG}rJ(jI]jJ]jK]jL]jN]ujBj-j<]rKjZXcabalrL…rM}rN(jAUjBjHubajEj‚ubjZXE will combine them and be able to download packages from any of them.rO…rP}rQ(jAXE will combine them and be able to download packages from any of them.jCNjPNjQhjBj-ubeubj>)rR}rS(jAUjBjjCjDjEjFjG}rT(jI]jJ]jK]jL]rUjajN]rVhfaujPK=jQhj<]rW(jS)rX}rY(jAXUsing secure repositoriesrZjBjRjCjDjEjWjG}r[(jI]jJ]jK]jL]jN]ujPK=jQhj<]r\jZXUsing secure repositoriesr]…r^}r_(jAjZjCNjPNjQhjBjXubaubjq)r`}ra(jAX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:rbjBjRjCjDjEjtjG}rc(jI]jJ]jK]jL]jN]ujPK?jQhj<]rdjZX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:re…rf}rg(jAjbjCNjPNjQhjBj`ubaubj®)rh}ri(jAXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: jBjRjCjDjEj±jG}rj(jµj¶jL]jK]jI]jJ]jN]ujPKEjQhj<]rkjZXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: rl…rm}rn(jAUjBjhubaubjq)ro}rp(jAXEThe ```` and ```` values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file ``root.json`` (for instance, http://hackage.haskell.org/root.json) which the client needs to do verification. However, how can ``cabal`` verify the ``root.json`` file *itself*? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, ``cabal`` will verify that the downloaded ``root.json`` file has been signed with at least ```` keys from your set of ````.jBjRjCjDjEjtjG}rq(jI]jJ]jK]jL]jN]ujPKKjQhj<]rr(jZXThe rs…rt}ru(jAXThe jCNjPNjQhjBjoubjz)rv}rw(jAX````jG}rx(jI]jJ]jK]jL]jN]ujBjoj<]ryjZXrz…r{}r|(jAUjBjvubajEj‚ubjZX and r}…r~}r(jAX and jCNjPNjQhjBjoubjz)r€}r(jAX````jG}r‚(jI]jJ]jK]jL]jN]ujBjoj<]rƒjZXr„…r…}r†(jAUjBj€ubajEj‚ubjZXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file r‡…rˆ}r‰(jAXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file jCNjPNjQhjBjoubjz)rŠ}r‹(jAX ``root.json``jG}rŒ(jI]jJ]jK]jL]jN]ujBjoj<]rjZX root.jsonrŽ…r}r(jAUjBjŠubajEj‚ubjZX (for instance, r‘…r’}r“(jAX (for instance, jCNjPNjQhjBjoubcdocutils.nodes reference r”)r•}r–(jAX$http://hackage.haskell.org/root.jsonr—jG}r˜(Urefurij—jL]jK]jI]jJ]jN]ujBjoj<]r™jZX$http://hackage.haskell.org/root.jsonrš…r›}rœ(jAUjBj•ubajEU referencerubjZX>) which the client needs to do verification. However, how can rž…rŸ}r (jAX>) which the client needs to do verification. However, how can jCNjPNjQhjBjoubjz)r¡}r¢(jAX ``cabal``jG}r£(jI]jJ]jK]jL]jN]ujBjoj<]r¤jZXcabalr¥…r¦}r§(jAUjBj¡ubajEj‚ubjZX verify the r¨…r©}rª(jAX verify the jCNjPNjQhjBjoubjz)r«}r¬(jAX ``root.json``jG}r­(jI]jJ]jK]jL]jN]ujBjoj<]r®jZX root.jsonr¯…r°}r±(jAUjBj«ubajEj‚ubjZX file r²…r³}r´(jAX file jCNjPNjQhjBjoubcdocutils.nodes emphasis rµ)r¶}r·(jAX*itself*jG}r¸(jI]jJ]jK]jL]jN]ujBjoj<]r¹jZXitselfrº…r»}r¼(jAUjBj¶ubajEUemphasisr½ubjZXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, r¾…r¿}rÀ(jAXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, jCNjPNjQhjBjoubjz)rÁ}rÂ(jAX ``cabal``jG}rÃ(jI]jJ]jK]jL]jN]ujBjoj<]rÄjZXcabalrÅ…rÆ}rÇ(jAUjBjÁubajEj‚ubjZX! will verify that the downloaded rÈ…rÉ}rÊ(jAX! will verify that the downloaded jCNjPNjQhjBjoubjz)rË}rÌ(jAX ``root.json``jG}rÍ(jI]jJ]jK]jL]jN]ujBjoj<]rÎjZX root.jsonrÏ…rÐ}rÑ(jAUjBjËubajEj‚ubjZX$ file has been signed with at least rÒ…rÓ}rÔ(jAX$ file has been signed with at least jCNjPNjQhjBjoubjz)rÕ}rÖ(jAX````jG}r×(jI]jJ]jK]jL]jN]ujBjoj<]rØjZXrÙ…rÚ}rÛ(jAUjBjÕubajEj‚ubjZX keys from your set of rÜ…rÝ}rÞ(jAX keys from your set of jCNjPNjQhjBjoubjz)rß}rà(jAX````jG}rá(jI]jJ]jK]jL]jN]ujBjoj<]râjZXrã…rä}rå(jAUjBjßubajEj‚ubjZX.…ræ}rç(jAX.jCNjPNjQhjBjoubeubjq)rè}ré(jAX>You can, but are not recommended to, omit these two fields. In that case ``cabal`` will download the ``root.json`` field and use it without verification. Although this bootstrapping step is then unsafe, all subsequent access is secure (provided that the downloaded ``root.json`` was not tempered with). Of course, adding ``root-keys`` and ``key-threshold`` to your repository specification only shifts the problem, because now you somehow need to make sure that the key IDs you received were the right ones. How that is done is however outside the scope of ``cabal`` proper.jBjRjCjDjEjtjG}rê(jI]jJ]jK]jL]jN]ujPKUjQhj<]rë(jZXIYou can, but are not recommended to, omit these two fields. In that case rì…rí}rî(jAXIYou can, but are not recommended to, omit these two fields. In that case jCNjPNjQhjBjèubjz)rï}rð(jAX ``cabal``jG}rñ(jI]jJ]jK]jL]jN]ujBjèj<]ròjZXcabalró…rô}rõ(jAUjBjïubajEj‚ubjZX will download the rö…r÷}rø(jAX will download the jCNjPNjQhjBjèubjz)rù}rú(jAX ``root.json``jG}rû(jI]jJ]jK]jL]jN]ujBjèj<]rüjZX root.jsonrý…rþ}rÿ(jAUjBjùubajEj‚ubjZX— field and use it without verification. Although this bootstrapping step is then unsafe, all subsequent access is secure (provided that the downloaded r…r}r(jAX— field and use it without verification. Although this bootstrapping step is then unsafe, all subsequent access is secure (provided that the downloaded jCNjPNjQhjBjèubjz)r}r(jAX ``root.json``jG}r(jI]jJ]jK]jL]jN]ujBjèj<]rjZX root.jsonr…r}r (jAUjBjubajEj‚ubjZX+ was not tempered with). Of course, adding r …r }r (jAX+ was not tempered with). Of course, adding jCNjPNjQhjBjèubjz)r }r(jAX ``root-keys``jG}r(jI]jJ]jK]jL]jN]ujBjèj<]rjZX root-keysr…r}r(jAUjBj ubajEj‚ubjZX and r…r}r(jAX and jCNjPNjQhjBjèubjz)r}r(jAX``key-threshold``jG}r(jI]jJ]jK]jL]jN]ujBjèj<]rjZX key-thresholdr…r}r(jAUjBjubajEj‚ubjZXÉ to your repository specification only shifts the problem, because now you somehow need to make sure that the key IDs you received were the right ones. How that is done is however outside the scope of r…r}r (jAXÉ to your repository specification only shifts the problem, because now you somehow need to make sure that the key IDs you received were the right ones. How that is done is however outside the scope of jCNjPNjQhjBjèubjz)r!}r"(jAX ``cabal``jG}r#(jI]jJ]jK]jL]jN]ujBjèj<]r$jZXcabalr%…r&}r'(jAUjBj!ubajEj‚ubjZX proper.r(…r)}r*(jAX proper.jCNjPNjQhjBjèubeubjq)r+}r,(jAXrMore information about the security infrastructure can be found at https://github.com/well-typed/hackage-security.jBjRjCjDjEjtjG}r-(jI]jJ]jK]jL]jN]ujPK_jQhj<]r.(jZXCMore information about the security infrastructure can be found at r/…r0}r1(jAXCMore information about the security infrastructure can be found at jCNjPNjQhjBj+ubj”)r2}r3(jAX.https://github.com/well-typed/hackage-securityr4jG}r5(Urefurij4jL]jK]jI]jJ]jN]ujBj+j<]r6jZX.https://github.com/well-typed/hackage-securityr7…r8}r9(jAUjBj2ubajEjubjZX.…r:}r;(jAX.jCNjPNjQhjBj+ubeubeubj>)r<}r=(jAUjBjjCjDjEjFjG}r>(jI]jJ]jK]jL]r?hÑajN]r@h.aujPKcjQhj<]rA(jS)rB}rC(jAXLegacy repositoriesrDjBj<jCjDjEjWjG}rE(jI]jJ]jK]jL]jN]ujPKcjQhj<]rFjZXLegacy repositoriesrG…rH}rI(jAjDjCNjPNjQhjBjBubaubjq)rJ}rK(jAXaCurrently ``cabal`` supports two kinds of “legacy†repositories. The first is specified usingjBj<jCjDjEjtjG}rL(jI]jJ]jK]jL]jN]ujPKejQhj<]rM(jZX Currently rN…rO}rP(jAX Currently jCNjPNjQhjBjJubjz)rQ}rR(jAX ``cabal``jG}rS(jI]jJ]jK]jL]jN]ujBjJj<]rTjZXcabalrU…rV}rW(jAUjBjQubajEj‚ubjZXN supports two kinds of “legacy†repositories. The first is specified usingrX…rY}rZ(jAXN supports two kinds of “legacy†repositories. The first is specified usingjCNjPNjQhjBjJubeubj®)r[}r\(jAXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archivejBj<jCjDjEj±jG}r](jµj¶jL]jK]jI]jJ]jN]ujPKjjQhj<]r^jZXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archiver_…r`}ra(jAUjBj[ubaubjq)rb}rc(jAX This is just syntactic sugar forrdjBj<jCjDjEjtjG}re(jI]jJ]jK]jL]jN]ujPKljQhj<]rfjZX This is just syntactic sugar forrg…rh}ri(jAjdjCNjPNjQhjBjbubaubj®)rj}rk(jAXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archivejBj<jCjDjEj±jG}rl(jµj¶jL]jK]jI]jJ]jN]ujPKpjQhj<]rmjZXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archivern…ro}rp(jAUjBjjubaubjq)rq}rr(jAX°although, in (and only in) the specific case of Hackage, the URL ``http://hackage.haskell.org/packages/archive`` will be silently translated to ``http://hackage.haskell.org/``.jBj<jCjDjEjtjG}rs(jI]jJ]jK]jL]jN]ujPKsjQhj<]rt(jZXAalthough, in (and only in) the specific case of Hackage, the URL ru…rv}rw(jAXAalthough, in (and only in) the specific case of Hackage, the URL jCNjPNjQhjBjqubjz)rx}ry(jAX/``http://hackage.haskell.org/packages/archive``jG}rz(jI]jJ]jK]jL]jN]ujBjqj<]r{jZX+http://hackage.haskell.org/packages/archiver|…r}}r~(jAUjBjxubajEj‚ubjZX will be silently translated to r…r€}r(jAX will be silently translated to jCNjPNjQhjBjqubjz)r‚}rƒ(jAX``http://hackage.haskell.org/``jG}r„(jI]jJ]jK]jL]jN]ujBjqj<]r…jZXhttp://hackage.haskell.org/r†…r‡}rˆ(jAUjBj‚ubajEj‚ubjZX.…r‰}rŠ(jAX.jCNjPNjQhjBjqubeubjq)r‹}rŒ(jAXNThe second kind of legacy repositories are so-called “local†repositories:rjBj<jCjDjEjtjG}rŽ(jI]jJ]jK]jL]jN]ujPKwjQhj<]rjZXNThe second kind of legacy repositories are so-called “local†repositories:r…r‘}r’(jAjjCNjPNjQhjBj‹ubaubj®)r“}r”(jAX-local-repo: my-local-repo:/path/to/local/repojBj<jCjDjEj±jG}r•(jµj¶jL]jK]jI]jJ]jN]ujPK|jQhj<]r–jZX-local-repo: my-local-repo:/path/to/local/repor—…r˜}r™(jAUjBj“ubaubjq)rš}r›(jAXÛThis can be used to access repositories on the local file system. However, the layout of these local repositories is different from the layout of remote repositories, and usage of these local repositories is deprecated.rœjBj<jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPK~jQhj<]ržjZXÛThis can be used to access repositories on the local file system. However, the layout of these local repositories is different from the layout of remote repositories, and usage of these local repositories is deprecated.rŸ…r }r¡(jAjœjCNjPNjQhjBjšubaubeubj>)r¢}r£(jAUjBjjCjDjEjFjG}r¤(jI]jJ]jK]jL]r¥h¶ajN]r¦haujPK„jQhj<]r§(jS)r¨}r©(jAXSecure local repositoriesrªjBj¢jCjDjEjWjG}r«(jI]jJ]jK]jL]jN]ujPK„jQhj<]r¬jZXSecure local repositoriesr­…r®}r¯(jAjªjCNjPNjQhjBj¨ubaubjq)r°}r±(jAXxIf you want to use repositories on your local file system, it is recommended instead to use a *secure* local repository:jBj¢jCjDjEjtjG}r²(jI]jJ]jK]jL]jN]ujPK†jQhj<]r³(jZX^If you want to use repositories on your local file system, it is recommended instead to use a r´…rµ}r¶(jAX^If you want to use repositories on your local file system, it is recommended instead to use a jCNjPNjQhjBj°ubjµ)r·}r¸(jAX*secure*jG}r¹(jI]jJ]jK]jL]jN]ujBj°j<]rºjZXsecurer»…r¼}r½(jAUjBj·ubajEj½ubjZX local repository:r¾…r¿}rÀ(jAX local repository:jCNjPNjQhjBj°ubeubj®)rÁ}rÂ(jAX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: jBj¢jCjDjEj±jG}rÃ(jµj¶jL]jK]jI]jJ]jN]ujPK‹jQhj<]rÄjZX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: rÅ…rÆ}rÇ(jAUjBjÁubaubjq)rÈ}rÉ(jAX²The layout of these secure local repos matches the layout of remote repositories exactly; the :hackage-pkg:`hackage-repo-tool` can be used to create and manage such repositories.jBj¢jCjDjEjtjG}rÊ(jI]jJ]jK]jL]jN]ujPK‘jQhj<]rË(jZX^The layout of these secure local repos matches the layout of remote repositories exactly; the rÌ…rÍ}rÎ(jAX^The layout of these secure local repos matches the layout of remote repositories exactly; the jCNjPNjQhjBjÈubj”)rÏ}rÐ(jAXhackage-repo-tooljG}rÑ(UrefuriX4http://hackage.haskell.org/package/hackage-repo-tooljL]jK]jI]jJ]jN]Uinternal‰ujBjÈj<]rÒjZXhackage-repo-toolrÓ…rÔ}rÕ(jAUjBjÏubajEjubjZX4 can be used to create and manage such repositories.rÖ…r×}rØ(jAX4 can be used to create and manage such repositories.jCNjPNjQhjBjÈubeubcdocutils.nodes target rÙ)rÚ}rÛ(jAX.. _installing-packages:jBj¢jCjDjEUtargetrÜjG}rÝ(jL]jK]jI]jJ]jN]UrefidrÞj.ujPK•jQhj<]ubeubeubeubj>)rß}rà(jAUjBhjCjDUexpect_referenced_by_namerá}râh’jÚsjEjFjG}rã(jI]jJ]jK]jL]rä(h¸j.ejN]rå(hh’eujPK˜jQhUexpect_referenced_by_idræ}rçj.jÚsj<]rè(jS)ré}rê(jAX Building and installing packagesrëjBjßjCjDjEjWjG}rì(jI]jJ]jK]jL]jN]ujPK˜jQhj<]ríjZX Building and installing packagesrî…rï}rð(jAjëjCNjPNjQhjBjéubaubj^)rñ}rò(jAUjBjßjCjDjEjajG}ró(UlangXconsoleUlinenothresholdI9223372036854775807 jL]jK]jI]jJ]jN]ujPK›jQhj<]ubjq)rô}rõ(jAXŽAfter you've unpacked a Cabal package, you can build it by moving into the root directory of the package and running the ``cabal`` tool there:jBjßjCjDjEjtjG}rö(jI]jJ]jK]jL]jN]ujPKœjQhj<]r÷(jZX{After you’ve unpacked a Cabal package, you can build it by moving into the root directory of the package and running the rø…rù}rú(jAXyAfter you've unpacked a Cabal package, you can build it by moving into the root directory of the package and running the jCNjPNjQhjBjôubjz)rû}rü(jAX ``cabal``jG}rý(jI]jJ]jK]jL]jN]ujBjôj<]rþjZXcabalrÿ…r}r(jAUjBjûubajEj‚ubjZX tool there:r…r}r(jAX tool there:jCNjPNjQhjBjôubeubj®)r}r(jAX$ cabal [command] [option...]jBjßjCjDjEj±jG}r(jµj¶jL]jK]jI]jJ]jN]ujPK¡jQhj<]rjZX$ cabal [command] [option...]r …r }r (jAUjBjubaubjq)r }r (jAXNThe *command* argument selects a particular step in the build/install process.jBjßjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPK£jQhj<]r(jZXThe r…r}r(jAXThe jCNjPNjQhjBj ubjµ)r}r(jAX *command*jG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZXcommandr…r}r(jAUjBjubajEj½ubjZXA argument selects a particular step in the build/install process.r…r}r(jAXA argument selects a particular step in the build/install process.jCNjPNjQhjBj ubeubjq)r}r(jAX5You can also get a summary of the command syntax withrjBjßjCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPK¦jQhj<]r!jZX5You can also get a summary of the command syntax withr"…r#}r$(jAjjCNjPNjQhjBjubaubj®)r%}r&(jAX $ cabal helpjBjßjCjDjEj±jG}r'(jµj¶jL]jK]jI]jJ]jN]ujPKªjQhj<]r(jZX $ cabal helpr)…r*}r+(jAUjBj%ubaubjq)r,}r-(jAXIAlternatively, you can also use the ``Setup.hs`` or ``Setup.lhs`` script:jBjßjCjDjEjtjG}r.(jI]jJ]jK]jL]jN]ujPK¬jQhj<]r/(jZX$Alternatively, you can also use the r0…r1}r2(jAX$Alternatively, you can also use the jCNjPNjQhjBj,ubjz)r3}r4(jAX ``Setup.hs``jG}r5(jI]jJ]jK]jL]jN]ujBj,j<]r6jZXSetup.hsr7…r8}r9(jAUjBj3ubajEj‚ubjZX or r:…r;}r<(jAX or jCNjPNjQhjBj,ubjz)r=}r>(jAX ``Setup.lhs``jG}r?(jI]jJ]jK]jL]jN]ujBj,j<]r@jZX Setup.lhsrA…rB}rC(jAUjBj=ubajEj‚ubjZX script:rD…rE}rF(jAX script:jCNjPNjQhjBj,ubeubj®)rG}rH(jAX+$ runhaskell Setup.hs [command] [option...]jBjßjCjDjEj±jG}rI(jµj¶jL]jK]jI]jJ]jN]ujPK±jQhj<]rJjZX+$ runhaskell Setup.hs [command] [option...]rK…rL}rM(jAUjBjGubaubjq)rN}rO(jAX+For the summary of the command syntax, run:rPjBjßjCjDjEjtjG}rQ(jI]jJ]jK]jL]jN]ujPK³jQhj<]rRjZX+For the summary of the command syntax, run:rS…rT}rU(jAjPjCNjPNjQhjBjNubaubj®)rV}rW(jAX $ cabal helpjBjßjCjDjEj±jG}rX(jµj¶jL]jK]jI]jJ]jN]ujPK·jQhj<]rYjZX $ cabal helprZ…r[}r\(jAUjBjVubaubjq)r]}r^(jAXorr_jBjßjCjDjEjtjG}r`(jI]jJ]jK]jL]jN]ujPK¹jQhj<]rajZXorrb…rc}rd(jAj_jCNjPNjQhjBj]ubaubj®)re}rf(jAX$ runhaskell Setup.hs --helpjBjßjCjDjEj±jG}rg(jµj¶jL]jK]jI]jJ]jN]ujPK½jQhj<]rhjZX$ runhaskell Setup.hs --helpri…rj}rk(jAUjBjeubaubj>)rl}rm(jAUjBjßjCjDjEjFjG}rn(jI]jJ]jK]jL]rojajN]rphmaujPKÀjQhj<]rq(jS)rr}rs(jAX(Building and installing a system packagertjBjljCjDjEjWjG}ru(jI]jJ]jK]jL]jN]ujPKÀjQhj<]rvjZX(Building and installing a system packagerw…rx}ry(jAjtjCNjPNjQhjBjrubaubj®)rz}r{(jAX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installjBjljCjDjEj±jG}r|(jµj¶jL]jK]jI]jJ]jN]ujPKÄjQhj<]r}jZX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installr~…r}r€(jAUjBjzubaubjq)r}r‚(jAX The first line readies the system to build the tool using GHC; for example, it checks that GHC exists on the system. The second line performs the actual building, while the last both copies the build results to some permanent place and registers the package with GHC.rƒjBjljCjDjEjtjG}r„(jI]jJ]jK]jL]jN]ujPKÈjQhj<]r…jZX The first line readies the system to build the tool using GHC; for example, it checks that GHC exists on the system. The second line performs the actual building, while the last both copies the build results to some permanent place and registers the package with GHC.r†…r‡}rˆ(jAjƒjCNjPNjQhjBjubaubeubj>)r‰}rŠ(jAUjBjßjCjDjEjFjG}r‹(jI]jJ]jK]jL]rŒhÈajN]rh%aujPKÎjQhj<]rŽ(jS)r}r(jAX&Building and installing a user packager‘jBj‰jCjDjEjWjG}r’(jI]jJ]jK]jL]jN]ujPKÎjQhj<]r“jZX&Building and installing a user packager”…r•}r–(jAj‘jCNjPNjQhjBjubaubj®)r—}r˜(jAX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installjBj‰jCjDjEj±jG}r™(jµj¶jL]jK]jI]jJ]jN]ujPKÒjQhj<]ršjZX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installr›…rœ}r(jAUjBj—ubaubjq)rž}rŸ(jAXThe package is installed under the user's home directory and is registered in the user's package database (:option:`setup configure --user`).jBj‰jCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPKÖjQhj<]r¡(jZXoThe package is installed under the user’s home directory and is registered in the user’s package database (r¢…r£}r¤(jAXkThe package is installed under the user's home directory and is registered in the user's package database (jCNjPNjQhjBjžubcsphinx.addnodes pending_xref r¥)r¦}r§(jAX :option:`setup configure --user`r¨jBjžjCjDjEU pending_xrefr©jG}rª(UreftypeXoptionUrefwarnr«ˆU reftargetr¬Xsetup configure --userU refdomainXstdr­jL]jK]U refexplicit‰jI]jJ]jN]Urefdocr®Xinstalling-packagesr¯U std:programr°NujPKÖj<]r±jz)r²}r³(jAj¨jG}r´(jI]jJ]rµ(Uxrefr¶j­X std-optionr·ejK]jL]jN]ujBj¦j<]r¸jZXsetup configure --userr¹…rº}r»(jAUjBj²ubajEj‚ubaubjZX).r¼…r½}r¾(jAX).jCNjPNjQhjBjžubeubeubj>)r¿}rÀ(jAUjBjßjCjDjEjFjG}rÁ(jI]jJ]jK]jL]rÂjajN]rÃh}aujPKÚjQhj<]rÄ(jS)rÅ}rÆ(jAX Installing packages from HackagerÇjBj¿jCjDjEjWjG}rÈ(jI]jJ]jK]jL]jN]ujPKÚjQhj<]rÉjZX Installing packages from HackagerÊ…rË}rÌ(jAjÇjCNjPNjQhjBjÅubaubjq)rÍ}rÎ(jAX”The ``cabal`` tool also can download, configure, build and install a Hackage_ package and all of its dependencies in a single step. To do this, run:jBj¿jCjDjEjtjG}rÏ(jI]jJ]jK]jL]jN]ujPKÜjQhj<]rÐ(jZXThe rÑ…rÒ}rÓ(jAXThe jCNjPNjQhjBjÍubjz)rÔ}rÕ(jAX ``cabal``jG}rÖ(jI]jJ]jK]jL]jN]ujBjÍj<]r×jZXcabalrØ…rÙ}rÚ(jAUjBjÔubajEj‚ubjZX8 tool also can download, configure, build and install a rÛ…rÜ}rÝ(jAX8 tool also can download, configure, build and install a jCNjPNjQhjBjÍubj”)rÞ}rß(jAXHackage_UresolvedràKjBjÍjEjjG}rá(UnameXHackageUrefurirâXhttp://hackage.haskell.org/rãjL]jK]jI]jJ]jN]uj<]räjZXHackagerå…ræ}rç(jAUjBjÞubaubjZXG package and all of its dependencies in a single step. To do this, run:rè…ré}rê(jAXG package and all of its dependencies in a single step. To do this, run:jCNjPNjQhjBjÍubeubj®)rë}rì(jAX$ cabal install [PACKAGE...]jBj¿jCjDjEj±jG}rí(jµj¶jL]jK]jI]jJ]jN]ujPKâjQhj<]rîjZX$ cabal install [PACKAGE...]rï…rð}rñ(jAUjBjëubaubjq)rò}ró(jAXFTo browse the list of available packages, visit the Hackage_ web site.jBj¿jCjDjEjtjG}rô(jI]jJ]jK]jL]jN]ujPKäjQhj<]rõ(jZX4To browse the list of available packages, visit the rö…r÷}rø(jAX4To browse the list of available packages, visit the jCNjPNjQhjBjòubj”)rù}rú(jAXHackage_jàKjBjòjEjjG}rû(UnameXHackagejâjãjL]jK]jI]jJ]jN]uj<]rüjZXHackagerý…rþ}rÿ(jAUjBjùubaubjZX web site.r…r}r(jAX web site.jCNjPNjQhjBjòubeubeubj>)r}r(jAUjBjßjCjDjEjFjG}r(jI]jJ]jK]jL]rj ajN]rhjaujPKèjQhj<]r(jS)r }r (jAXDeveloping with sandboxesr jBjjCjDjEjWjG}r (jI]jJ]jK]jL]jN]ujPKèjQhj<]r jZXDeveloping with sandboxesr…r}r(jAj jCNjPNjQhjBj ubaubjq)r}r(jAXéBy default, any dependencies of the package are installed into the global or user package databases (e.g. using ``cabal install --only-dependencies``). If you're building several different packages that have incompatible dependencies, this can cause the build to fail. One way to avoid this problem is to build each package in an isolated environment ("sandbox"), with a sandbox-local package database. Because sandboxes are per-project, inconsistent dependencies can be simply disallowed.jBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPKêjQhj<]r(jZXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using r…r}r(jAXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using jCNjPNjQhjBjubjz)r}r(jAX%``cabal install --only-dependencies``jG}r(jI]jJ]jK]jL]jN]ujBjj<]rjZX!cabal install --only-dependenciesr…r}r(jAUjBjubajEj‚ubjZXZ). If you’re building several different packages that have incompatible dependencies, this can cause the build to fail. One way to avoid this problem is to build each package in an isolated environment (“sandboxâ€), with a sandbox-local package database. Because sandboxes are per-project, inconsistent dependencies can be simply disallowed.r…r }r!(jAXT). If you're building several different packages that have incompatible dependencies, this can cause the build to fail. One way to avoid this problem is to build each package in an isolated environment ("sandbox"), with a sandbox-local package database. Because sandboxes are per-project, inconsistent dependencies can be simply disallowed.jCNjPNjQhjBjubeubjq)r"}r#(jAXiFor more on sandboxes, see also `this article `__.jBjjCjDjEjtjG}r$(jI]jJ]jK]jL]jN]ujPKójQhj<]r%(jZX For more on sandboxes, see also r&…r'}r((jAX For more on sandboxes, see also jCNjPNjQhjBj"ubj”)r)}r*(jAXH`this article `__jG}r+(UnameX this articlejâX5http://coldwa.st/e/blog/2013-08-20-Cabal-sandbox.htmljL]jK]jI]jJ]jN]ujBj"j<]r,jZX this articler-…r.}r/(jAUjBj)ubajEjubjZX.…r0}r1(jAX.jCNjPNjQhjBj"ubeubj>)r2}r3(jAUjBjjCjDjEjFjG}r4(jI]jJ]jK]jL]r5h¼ajN]r6haujPK÷jQhj<]r7(jS)r8}r9(jAXSandboxes: basic usager:jBj2jCjDjEjWjG}r;(jI]jJ]jK]jL]jN]ujPK÷jQhj<]r<jZXSandboxes: basic usager=…r>}r?(jAj:jCNjPNjQhjBj8ubaubjq)r@}rA(jAXµTo initialise a fresh sandbox in the current directory, run ``cabal sandbox init``. All subsequent commands (such as ``build`` and ``install``) from this point will use the sandbox.jBj2jCjDjEjtjG}rB(jI]jJ]jK]jL]jN]ujPKùjQhj<]rC(jZX<To initialise a fresh sandbox in the current directory, run rD…rE}rF(jAX<To initialise a fresh sandbox in the current directory, run jCNjPNjQhjBj@ubjz)rG}rH(jAX``cabal sandbox init``jG}rI(jI]jJ]jK]jL]jN]ujBj@j<]rJjZXcabal sandbox initrK…rL}rM(jAUjBjGubajEj‚ubjZX#. All subsequent commands (such as rN…rO}rP(jAX#. All subsequent commands (such as jCNjPNjQhjBj@ubjz)rQ}rR(jAX ``build``jG}rS(jI]jJ]jK]jL]jN]ujBj@j<]rTjZXbuildrU…rV}rW(jAUjBjQubajEj‚ubjZX and rX…rY}rZ(jAX and jCNjPNjQhjBj@ubjz)r[}r\(jAX ``install``jG}r](jI]jJ]jK]jL]jN]ujBj@j<]r^jZXinstallr_…r`}ra(jAUjBj[ubajEj‚ubjZX') from this point will use the sandbox.rb…rc}rd(jAX') from this point will use the sandbox.jCNjPNjQhjBj@ubeubj®)re}rf(jAXþ$ cd /path/to/my/haskell/library $ cabal sandbox init # Initialise the sandbox $ cabal install --only-dependencies # Install dependencies into the sandbox $ cabal build # Build your package inside the sandboxjBj2jCjDjEj±jG}rg(jµj¶jL]jK]jI]jJ]jN]ujPKÿjQhj<]rhjZXþ$ cd /path/to/my/haskell/library $ cabal sandbox init # Initialise the sandbox $ cabal install --only-dependencies # Install dependencies into the sandbox $ cabal build # Build your package inside the sandboxri…rj}rk(jAUjBjeubaubjq)rl}rm(jAX`It can be useful to make a source package available for installation in the sandbox - for example, if your package depends on a patched or an unreleased version of a library. This can be done with the ``cabal sandbox add-source`` command - think of it as "local Hackage_". If an add-source dependency is later modified, it is reinstalled automatically.jBj2jCjDjEjtjG}rn(jI]jJ]jK]jL]jN]ujPMjQhj<]ro(jZXÉIt can be useful to make a source package available for installation in the sandbox - for example, if your package depends on a patched or an unreleased version of a library. This can be done with the rp…rq}rr(jAXÉIt can be useful to make a source package available for installation in the sandbox - for example, if your package depends on a patched or an unreleased version of a library. This can be done with the jCNjPNjQhjBjlubjz)rs}rt(jAX``cabal sandbox add-source``jG}ru(jI]jJ]jK]jL]jN]ujBjlj<]rvjZXcabal sandbox add-sourcerw…rx}ry(jAUjBjsubajEj‚ubjZX# command - think of it as “local rz…r{}r|(jAX! command - think of it as "local jCNjPNjQhjBjlubj”)r}}r~(jAXHackage_jàKjBjljEjjG}r(UnameXHackagejâjãjL]jK]jI]jJ]jN]uj<]r€jZXHackager…r‚}rƒ(jAUjBj}ubaubjZXTâ€. If an add-source dependency is later modified, it is reinstalled automatically.r„…r…}r†(jAXR". If an add-source dependency is later modified, it is reinstalled automatically.jCNjPNjQhjBjlubeubj®)r‡}rˆ(jAXš$ cabal sandbox add-source /my/patched/library # Add a new add-source dependency $ cabal install --dependencies-only # Install it into the sandbox $ cabal build # Build the local package $ $EDITOR /my/patched/library/Source.hs # Modify the add-source dependency $ cabal build # Modified dependency is automatically reinstalledjBj2jCjDjEj±jG}r‰(jµj¶jL]jK]jI]jJ]jN]ujPM jQhj<]rŠjZXš$ cabal sandbox add-source /my/patched/library # Add a new add-source dependency $ cabal install --dependencies-only # Install it into the sandbox $ cabal build # Build the local package $ $EDITOR /my/patched/library/Source.hs # Modify the add-source dependency $ cabal build # Modified dependency is automatically reinstalledr‹…rŒ}r(jAUjBj‡ubaubjq)rŽ}r(jAX­Normally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (``$HOME/cabal/config``). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a ``cabal.config`` file in the same directory with your ``cabal.sandbox.config`` (which was created by ``sandbox init``). This file has the same syntax as the main Cabal config file.jBj2jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMjQhj<]r‘(jZXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (r’…r“}r”(jAXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (jCNjPNjQhjBjŽubjz)r•}r–(jAX``$HOME/cabal/config``jG}r—(jI]jJ]jK]jL]jN]ujBjŽj<]r˜jZX$HOME/cabal/configr™…rš}r›(jAUjBj•ubajEj‚ubjZXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a rœ…r}rž(jAXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a jCNjPNjQhjBjŽubjz)rŸ}r (jAX``cabal.config``jG}r¡(jI]jJ]jK]jL]jN]ujBjŽj<]r¢jZX cabal.configr£…r¤}r¥(jAUjBjŸubajEj‚ubjZX& file in the same directory with your r¦…r§}r¨(jAX& file in the same directory with your jCNjPNjQhjBjŽubjz)r©}rª(jAX``cabal.sandbox.config``jG}r«(jI]jJ]jK]jL]jN]ujBjŽj<]r¬jZXcabal.sandbox.configr­…r®}r¯(jAUjBj©ubajEj‚ubjZX (which was created by r°…r±}r²(jAX (which was created by jCNjPNjQhjBjŽubjz)r³}r´(jAX``sandbox init``jG}rµ(jI]jJ]jK]jL]jN]ujBjŽj<]r¶jZX sandbox initr·…r¸}r¹(jAUjBj³ubajEj‚ubjZX?). This file has the same syntax as the main Cabal config file.rº…r»}r¼(jAX?). This file has the same syntax as the main Cabal config file.jCNjPNjQhjBjŽubeubj®)r½}r¾(jAX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filejBj2jCjDjEj±jG}r¿(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rÀjZX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filerÁ…rÂ}rÃ(jAUjBj½ubaubjq)rÄ}rÅ(jAXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÆjBj2jCjDjEjtjG}rÇ(jI]jJ]jK]jL]jN]ujPM!jQhj<]rÈjZXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÉ…rÊ}rË(jAjÆjCNjPNjQhjBjÄubaubj®)rÌ}rÍ(jAXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodjBj2jCjDjEj±jG}rÎ(jµj¶jL]jK]jI]jJ]jN]ujPM&jQhj<]rÏjZXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodrÐ…rÑ}rÒ(jAUjBjÌubaubeubj>)rÓ}rÔ(jAUjBjjCjDjEjFjG}rÕ(jI]jJ]jK]jL]rÖh­ajN]r×h aujPM*jQhj<]rØ(jS)rÙ}rÚ(jAXSandboxes: advanced usagerÛjBjÓjCjDjEjWjG}rÜ(jI]jJ]jK]jL]jN]ujPM*jQhj<]rÝjZXSandboxes: advanced usagerÞ…rß}rà(jAjÛjCNjPNjQhjBjÙubaubjq)rá}râ(jAXThe default behaviour of the ``add-source`` command is to track modifications done to the added dependency and reinstall the sandbox copy of the package when needed. Sometimes this is not desirable: in these cases you can use ``add-source --snapshot``, which disables the change tracking. In addition to ``add-source``, there are also ``list-sources`` and ``delete-source`` commands.jBjÓjCjDjEjtjG}rã(jI]jJ]jK]jL]jN]ujPM,jQhj<]rä(jZXThe default behaviour of the rå…ræ}rç(jAXThe default behaviour of the jCNjPNjQhjBjáubjz)rè}ré(jAX``add-source``jG}rê(jI]jJ]jK]jL]jN]ujBjáj<]rëjZX add-sourcerì…rí}rî(jAUjBjèubajEj‚ubjZX· command is to track modifications done to the added dependency and reinstall the sandbox copy of the package when needed. Sometimes this is not desirable: in these cases you can use rï…rð}rñ(jAX· command is to track modifications done to the added dependency and reinstall the sandbox copy of the package when needed. Sometimes this is not desirable: in these cases you can use jCNjPNjQhjBjáubjz)rò}ró(jAX``add-source --snapshot``jG}rô(jI]jJ]jK]jL]jN]ujBjáj<]rõjZXadd-source --snapshotrö…r÷}rø(jAUjBjòubajEj‚ubjZX5, which disables the change tracking. In addition to rù…rú}rû(jAX5, which disables the change tracking. In addition to jCNjPNjQhjBjáubjz)rü}rý(jAX``add-source``jG}rþ(jI]jJ]jK]jL]jN]ujBjáj<]rÿjZX add-sourcer…r}r(jAUjBjüubajEj‚ubjZX, there are also r…r}r(jAX, there are also jCNjPNjQhjBjáubjz)r}r(jAX``list-sources``jG}r(jI]jJ]jK]jL]jN]ujBjáj<]r jZX list-sourcesr …r }r (jAUjBjubajEj‚ubjZX and r …r}r(jAX and jCNjPNjQhjBjáubjz)r}r(jAX``delete-source``jG}r(jI]jJ]jK]jL]jN]ujBjáj<]rjZX delete-sourcer…r}r(jAUjBjubajEj‚ubjZX commands.r…r}r(jAX commands.jCNjPNjQhjBjáubeubjq)r}r(jAXSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the ``--sandbox`` option:jBjÓjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM3jQhj<]r(jZXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the r…r}r (jAXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the jCNjPNjQhjBjubjz)r!}r"(jAX ``--sandbox``jG}r#(jI]jJ]jK]jL]jN]ujBjj<]r$jZX --sandboxr%…r&}r'(jAUjBj!ubajEj‚ubjZX option:r(…r)}r*(jAX option:jCNjPNjQhjBjubeubj®)r+}r,(jAXþ$ mkdir -p /path/to/shared-sandbox $ cd /path/to/shared-sandbox $ cabal sandbox init --sandbox . $ cd /path/to/package-a $ cabal sandbox init --sandbox /path/to/shared-sandbox $ cd /path/to/package-b $ cabal sandbox init --sandbox /path/to/shared-sandboxjBjÓjCjDjEj±jG}r-(jµj¶jL]jK]jI]jJ]jN]ujPM8jQhj<]r.jZXþ$ mkdir -p /path/to/shared-sandbox $ cd /path/to/shared-sandbox $ cabal sandbox init --sandbox . $ cd /path/to/package-a $ cabal sandbox init --sandbox /path/to/shared-sandbox $ cd /path/to/package-b $ cabal sandbox init --sandbox /path/to/shared-sandboxr/…r0}r1(jAUjBj+ubaubjq)r2}r3(jAXõNote that ``cabal sandbox init --sandbox .`` puts all sandbox files into the current directory. By default, ``cabal sandbox init`` initialises a new sandbox in a newly-created subdirectory of the current working directory (``./.cabal-sandbox``).jBjÓjCjDjEjtjG}r4(jI]jJ]jK]jL]jN]ujPM@jQhj<]r5(jZX Note that r6…r7}r8(jAX Note that jCNjPNjQhjBj2ubjz)r9}r:(jAX"``cabal sandbox init --sandbox .``jG}r;(jI]jJ]jK]jL]jN]ujBj2j<]r<jZXcabal sandbox init --sandbox .r=…r>}r?(jAUjBj9ubajEj‚ubjZX@ puts all sandbox files into the current directory. By default, r@…rA}rB(jAX@ puts all sandbox files into the current directory. By default, jCNjPNjQhjBj2ubjz)rC}rD(jAX``cabal sandbox init``jG}rE(jI]jJ]jK]jL]jN]ujBj2j<]rFjZXcabal sandbox initrG…rH}rI(jAUjBjCubajEj‚ubjZX] initialises a new sandbox in a newly-created subdirectory of the current working directory (rJ…rK}rL(jAX] initialises a new sandbox in a newly-created subdirectory of the current working directory (jCNjPNjQhjBj2ubjz)rM}rN(jAX``./.cabal-sandbox``jG}rO(jI]jJ]jK]jL]jN]ujBj2j<]rPjZX./.cabal-sandboxrQ…rR}rS(jAUjBjMubajEj‚ubjZX).rT…rU}rV(jAX).jCNjPNjQhjBj2ubeubjq)rW}rX(jAXcUsing multiple different compiler versions simultaneously is also supported, via the ``-w`` option:jBjÓjCjDjEjtjG}rY(jI]jJ]jK]jL]jN]ujPMEjQhj<]rZ(jZXUUsing multiple different compiler versions simultaneously is also supported, via the r[…r\}r](jAXUUsing multiple different compiler versions simultaneously is also supported, via the jCNjPNjQhjBjWubjz)r^}r_(jAX``-w``jG}r`(jI]jJ]jK]jL]jN]ujBjWj<]rajZX-wrb…rc}rd(jAUjBj^ubajEj‚ubjZX option:re…rf}rg(jAX option:jCNjPNjQhjBjWubeubj®)rh}ri(jAXs$ cabal sandbox init $ cabal install --only-dependencies -w /path/to/ghc-1 # Install dependencies for both compilers $ cabal install --only-dependencies -w /path/to/ghc-2 $ cabal configure -w /path/to/ghc-1 # Build with the first compiler $ cabal build $ cabal configure -w /path/to/ghc-2 # Build with the second compiler $ cabal buildjBjÓjCjDjEj±jG}rj(jµj¶jL]jK]jI]jJ]jN]ujPMJjQhj<]rkjZXs$ cabal sandbox init $ cabal install --only-dependencies -w /path/to/ghc-1 # Install dependencies for both compilers $ cabal install --only-dependencies -w /path/to/ghc-2 $ cabal configure -w /path/to/ghc-1 # Build with the first compiler $ cabal build $ cabal configure -w /path/to/ghc-2 # Build with the second compiler $ cabal buildrl…rm}rn(jAUjBjhubaubjq)ro}rp(jAXIIt can be occasionally useful to run the compiler-specific package manager tool (e.g. ``ghc-pkg``) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The ``cabal sandbox hc-pkg`` command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:jBjÓjCjDjEjtjG}rq(jI]jJ]jK]jL]jN]ujPMRjQhj<]rr(jZXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. rs…rt}ru(jAXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. jCNjPNjQhjBjoubjz)rv}rw(jAX ``ghc-pkg``jG}rx(jI]jJ]jK]jL]jN]ujBjoj<]ryjZXghc-pkgrz…r{}r|(jAUjBjvubajEj‚ubjZXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The r}…r~}r(jAXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The jCNjPNjQhjBjoubjz)r€}r(jAX``cabal sandbox hc-pkg``jG}r‚(jI]jJ]jK]jL]jN]ujBjoj<]rƒjZXcabal sandbox hc-pkgr„…r…}r†(jAUjBj€ubajEj‚ubjZXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:r‡…rˆ}r‰(jAXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:jCNjPNjQhjBjoubeubj®)rŠ}r‹(jAXâ$ cabal -v sandbox hc-pkg list Using a sandbox located at /path/to/.cabal-sandbox 'ghc-pkg' '--global' '--no-user-package-conf' '--package-conf=/path/to/.cabal-sandbox/i386-linux-ghc-7.4.2-packages.conf.d' 'list' [...]jBjÓjCjDjEj±jG}rŒ(jµj¶jL]jK]jI]jJ]jN]ujPMZjQhj<]rjZXâ$ cabal -v sandbox hc-pkg list Using a sandbox located at /path/to/.cabal-sandbox 'ghc-pkg' '--global' '--no-user-package-conf' '--package-conf=/path/to/.cabal-sandbox/i386-linux-ghc-7.4.2-packages.conf.d' 'list' [...]rŽ…r}r(jAUjBjŠubaubjq)r‘}r’(jAX¢The ``--require-sandbox`` option makes all sandbox-aware commands (``install``/``build``/etc.) exit with error if there is no sandbox present. This makes it harder to accidentally modify the user package database. The option can be also turned on via the per-user configuration file (``~/.cabal/config``) or the per-project one (``$PROJECT_DIR/cabal.config``). The error can be squelched with ``--no-require-sandbox``.jBjÓjCjDjEjtjG}r“(jI]jJ]jK]jL]jN]ujPMajQhj<]r”(jZXThe r•…r–}r—(jAXThe jCNjPNjQhjBj‘ubjz)r˜}r™(jAX``--require-sandbox``jG}rš(jI]jJ]jK]jL]jN]ujBj‘j<]r›jZX--require-sandboxrœ…r}rž(jAUjBj˜ubajEj‚ubjZX* option makes all sandbox-aware commands (rŸ…r }r¡(jAX* option makes all sandbox-aware commands (jCNjPNjQhjBj‘ubjz)r¢}r£(jAX ``install``jG}r¤(jI]jJ]jK]jL]jN]ujBj‘j<]r¥jZXinstallr¦…r§}r¨(jAUjBj¢ubajEj‚ubjZX/…r©}rª(jAX/jCNjPNjQhjBj‘ubjz)r«}r¬(jAX ``build``jG}r­(jI]jJ]jK]jL]jN]ujBj‘j<]r®jZXbuildr¯…r°}r±(jAUjBj«ubajEj‚ubjZXÄ/etc.) exit with error if there is no sandbox present. This makes it harder to accidentally modify the user package database. The option can be also turned on via the per-user configuration file (r²…r³}r´(jAXÄ/etc.) exit with error if there is no sandbox present. This makes it harder to accidentally modify the user package database. The option can be also turned on via the per-user configuration file (jCNjPNjQhjBj‘ubjz)rµ}r¶(jAX``~/.cabal/config``jG}r·(jI]jJ]jK]jL]jN]ujBj‘j<]r¸jZX~/.cabal/configr¹…rº}r»(jAUjBjµubajEj‚ubjZX) or the per-project one (r¼…r½}r¾(jAX) or the per-project one (jCNjPNjQhjBj‘ubjz)r¿}rÀ(jAX``$PROJECT_DIR/cabal.config``jG}rÁ(jI]jJ]jK]jL]jN]ujBj‘j<]rÂjZX$PROJECT_DIR/cabal.configrÃ…rÄ}rÅ(jAUjBj¿ubajEj‚ubjZX#). The error can be squelched with rÆ…rÇ}rÈ(jAX#). The error can be squelched with jCNjPNjQhjBj‘ubjz)rÉ}rÊ(jAX``--no-require-sandbox``jG}rË(jI]jJ]jK]jL]jN]ujBj‘j<]rÌjZX--no-require-sandboxrÍ…rÎ}rÏ(jAUjBjÉubajEj‚ubjZX.…rÐ}rÑ(jAX.jCNjPNjQhjBj‘ubeubjq)rÒ}rÓ(jAXThe option ``--sandbox-config-file`` allows to specify the location of the ``cabal.sandbox.config`` file (by default, ``cabal`` searches for it in the current directory). This provides the same functionality as shared sandboxes, but sometimes can be more convenient. Example:jBjÓjCjDjEjtjG}rÔ(jI]jJ]jK]jL]jN]ujPMijQhj<]rÕ(jZX The option rÖ…r×}rØ(jAX The option jCNjPNjQhjBjÒubjz)rÙ}rÚ(jAX``--sandbox-config-file``jG}rÛ(jI]jJ]jK]jL]jN]ujBjÒj<]rÜjZX--sandbox-config-filerÝ…rÞ}rß(jAUjBjÙubajEj‚ubjZX' allows to specify the location of the rà…rá}râ(jAX' allows to specify the location of the jCNjPNjQhjBjÒubjz)rã}rä(jAX``cabal.sandbox.config``jG}rå(jI]jJ]jK]jL]jN]ujBjÒj<]ræjZXcabal.sandbox.configrç…rè}ré(jAUjBjãubajEj‚ubjZX file (by default, rê…rë}rì(jAX file (by default, jCNjPNjQhjBjÒubjz)rí}rî(jAX ``cabal``jG}rï(jI]jJ]jK]jL]jN]ujBjÒj<]rðjZXcabalrñ…rò}ró(jAUjBjíubajEj‚ubjZX” searches for it in the current directory). This provides the same functionality as shared sandboxes, but sometimes can be more convenient. Example:rô…rõ}rö(jAX” searches for it in the current directory). This provides the same functionality as shared sandboxes, but sometimes can be more convenient. Example:jCNjPNjQhjBjÒubeubj®)r÷}rø(jAXT$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cd /path/to/my/project $ cabal --sandbox-config-file=/path/to/my/sandbox/cabal.sandbox.config install # Uses the sandbox located at /path/to/my/sandbox/.cabal-sandbox $ cd ~ $ cabal --sandbox-config-file=/path/to/my/sandbox/cabal.sandbox.config install # Still uses the same sandboxjBjÓjCjDjEj±jG}rù(jµj¶jL]jK]jI]jJ]jN]ujPMpjQhj<]rújZXT$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cd /path/to/my/project $ cabal --sandbox-config-file=/path/to/my/sandbox/cabal.sandbox.config install # Uses the sandbox located at /path/to/my/sandbox/.cabal-sandbox $ cd ~ $ cabal --sandbox-config-file=/path/to/my/sandbox/cabal.sandbox.config install # Still uses the same sandboxrû…rü}rý(jAUjBj÷ubaubjq)rþ}rÿ(jAXdThe sandbox config file can be also specified via the ``CABAL_SANDBOX_CONFIG`` environment variable.jBjÓjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMzjQhj<]r(jZX6The sandbox config file can be also specified via the r…r}r(jAX6The sandbox config file can be also specified via the jCNjPNjQhjBjþubjz)r}r(jAX``CABAL_SANDBOX_CONFIG``jG}r(jI]jJ]jK]jL]jN]ujBjþj<]rjZXCABAL_SANDBOX_CONFIGr …r }r (jAUjBjubajEj‚ubjZX environment variable.r …r }r(jAX environment variable.jCNjPNjQhjBjþubeubjq)r}r(jAXWFinally, the flag ``--ignore-sandbox`` lets you temporarily ignore an existing sandbox:jBjÓjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM}jQhj<]r(jZXFinally, the flag r…r}r(jAXFinally, the flag jCNjPNjQhjBjubjz)r}r(jAX``--ignore-sandbox``jG}r(jI]jJ]jK]jL]jN]ujBjj<]rjZX--ignore-sandboxr…r}r(jAUjBjubajEj‚ubjZX1 lets you temporarily ignore an existing sandbox:r…r}r(jAX1 lets you temporarily ignore an existing sandbox:jCNjPNjQhjBjubeubj®)r }r!(jAXš$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cabal --ignore-sandbox install text # Installs 'text' in the user package database ('~/.cabal').jBjÓjCjDjEj±jG}r"(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]r#jZXš$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cabal --ignore-sandbox install text # Installs 'text' in the user package database ('~/.cabal').r$…r%}r&(jAUjBj ubaubeubeubj>)r'}r((jAUjBjßjCjDjEjFjG}r)(jI]jJ]jK]jL]r*hºajN]r+haujPM‰jQhj<]r,(jS)r-}r.(jAXCreating a binary packager/jBj'jCjDjEjWjG}r0(jI]jJ]jK]jL]jN]ujPM‰jQhj<]r1jZXCreating a binary packager2…r3}r4(jAj/jCNjPNjQhjBj-ubaubjq)r5}r6(jAX When creating binary packages (e.g. for Red Hat or Debian) one needs to create a tarball that can be sent to another system for unpacking in the root directory:r7jBj'jCjDjEjtjG}r8(jI]jJ]jK]jL]jN]ujPM‹jQhj<]r9jZX When creating binary packages (e.g. for Red Hat or Debian) one needs to create a tarball that can be sent to another system for unpacking in the root directory:r:…r;}r<(jAj7jCNjPNjQhjBj5ubaubj®)r=}r>(jAX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/jBj'jCjDjEj±jG}r?(jµj¶jL]jK]jI]jJ]jN]ujPM‘jQhj<]r@jZX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/rA…rB}rC(jAUjBj=ubaubjq)rD}rE(jAXAIf the package contains a library, you need two additional steps:rFjBj'jCjDjEjtjG}rG(jI]jJ]jK]jL]jN]ujPM–jQhj<]rHjZXAIf the package contains a library, you need two additional steps:rI…rJ}rK(jAjFjCNjPNjQhjBjDubaubj®)rL}rM(jAXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptjBj'jCjDjEj±jG}rN(jµj¶jL]jK]jI]jJ]jN]ujPMšjQhj<]rOjZXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptrP…rQ}rR(jAUjBjLubaubjq)rS}rT(jAXfThis creates shell scripts ``register.sh`` and ``unregister.sh``, which must also be sent to the target system. After unpacking there, the package must be registered by running the ``register.sh`` script. The ``unregister.sh`` script would be used in the uninstall procedure of the package. Similar steps may be used for creating binary packages for Windows.jBj'jCjDjEjtjG}rU(jI]jJ]jK]jL]jN]ujPMjQhj<]rV(jZXThis creates shell scripts rW…rX}rY(jAXThis creates shell scripts jCNjPNjQhjBjSubjz)rZ}r[(jAX``register.sh``jG}r\(jI]jJ]jK]jL]jN]ujBjSj<]r]jZX register.shr^…r_}r`(jAUjBjZubajEj‚ubjZX and ra…rb}rc(jAX and jCNjPNjQhjBjSubjz)rd}re(jAX``unregister.sh``jG}rf(jI]jJ]jK]jL]jN]ujBjSj<]rgjZX unregister.shrh…ri}rj(jAUjBjdubajEj‚ubjZXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the rk…rl}rm(jAXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the jCNjPNjQhjBjSubjz)rn}ro(jAX``register.sh``jG}rp(jI]jJ]jK]jL]jN]ujBjSj<]rqjZX register.shrr…rs}rt(jAUjBjnubajEj‚ubjZX script. The ru…rv}rw(jAX script. The jCNjPNjQhjBjSubjz)rx}ry(jAX``unregister.sh``jG}rz(jI]jJ]jK]jL]jN]ujBjSj<]r{jZX unregister.shr|…r}}r~(jAUjBjxubajEj‚ubjZX„ script would be used in the uninstall procedure of the package. Similar steps may be used for creating binary packages for Windows.r…r€}r(jAX„ script would be used in the uninstall procedure of the package. Similar steps may be used for creating binary packages for Windows.jCNjPNjQhjBjSubeubjq)r‚}rƒ(jAX5The following options are understood by all commands:r„jBj'jCjDjEjtjG}r…(jI]jJ]jK]jL]jN]ujPM¤jQhj<]r†jZX5The following options are understood by all commands:r‡…rˆ}r‰(jAj„jCNjPNjQhjBj‚ubaubcsphinx.addnodes index rŠ)r‹}rŒ(jAUjBj'jCjDjEUindexrjG}rŽ(jL]jK]jI]jJ]jN]Uentries]r(UpairrX+setup command line option; --help, -h or -?hàUNtr‘aujPNjQhj<]ubcsphinx.addnodes desc r’)r“}r”(jAUjBj'jCjDjEUdescr•jG}r–(Unoindexr—‰Udomainr˜XstdjL]jK]jI]jJ]jN]Uobjtyper™XoptionršUdesctyper›jšujPNjQhj<]rœ(csphinx.addnodes desc_signature r)rž}rŸ(jAX--help, -h or -?jBj“jCjDjEUdesc_signaturer jG}r¡(Uallnamesr¢]r£(X--helpr¤X-hr¥ejL]r¦hàajK]jI]jJ]jN]r§(hŒh=eUfirstr¨‰ujPM«jQhj<]r©(csphinx.addnodes desc_name rª)r«}r¬(jAj¤jBjžjCjDjEU desc_namer­jG}r®(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]r¯jZX--helpr°…r±}r²(jAUjCNjPNjQhjBj«ubaubcsphinx.addnodes desc_addname r³)r´}rµ(jAUjBjžjCjDjEU desc_addnamer¶jG}r·(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]ubj³)r¸}r¹(jAU, rºjBjžjCjDjEj¶jG}r»(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]r¼jZX, r½…r¾}r¿(jAUjCNjPNjQhjBj¸ubaubjª)rÀ}rÁ(jAj¥jBjžjCjDjEj­jG}rÂ(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]rÃjZX-hrÄ…rÅ}rÆ(jAUjCNjPNjQhjBjÀubaubj³)rÇ}rÈ(jAX or -?jBjžjCjDjEj¶jG}rÉ(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]rÊjZX or -?rË…rÌ}rÍ(jAUjCNjPNjQhjBjÇubaubeubcsphinx.addnodes desc_content rÎ)rÏ}rÐ(jAUjBj“jCjDjEU desc_contentrÑjG}rÒ(jI]jJ]jK]jL]jN]ujPM«jQhj<]rÓjq)rÔ}rÕ(jAX+List the available options for the command.rÖjBjÏjCjDjEjtjG}r×(jI]jJ]jK]jL]jN]ujPMªjQhj<]rØjZX+List the available options for the command.rÙ…rÚ}rÛ(jAjÖjCNjPNjQhjBjÔubaubaubeubjŠ)rÜ}rÝ(jAUjBj'jCjDjEjjG}rÞ(jL]jK]jI]jJ]jN]Uentries]rß(jX.setup command line option; --verbose=n or -v nj9UNtràaujPNjQhj<]ubj’)rá}râ(jAUjBj'jCjDjEj•jG}rã(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionräj›jäujPNjQhj<]rå(j)ræ}rç(jAX--verbose=n or -v njBjájCjDjEj jG}rè(j¢]réX --verboserêajL]rëj9ajK]jI]jJ]jN]rìhaj¨‰ujPM¹jQhj<]rí(jª)rî}rï(jAjêjBjæjCjDjEj­jG}rð(jµj¶jL]jK]jI]jJ]jN]ujPM¹jQhj<]rñjZX --verboserò…ró}rô(jAUjCNjPNjQhjBjîubaubj³)rõ}rö(jAX =n or -v njBjæjCjDjEj¶jG}r÷(jµj¶jL]jK]jI]jJ]jN]ujPM¹jQhj<]røjZX =n or -v nrù…rú}rû(jAUjCNjPNjQhjBjõubaubeubjÎ)rü}rý(jAUjBjájCjDjEjÑjG}rþ(jI]jJ]jK]jL]jN]ujPM¹jQhj<]rÿ(jq)r}r(jAXRSet the verbosity level (0-3). The normal level is 1; a missing *n* defaults to 2.jBjüjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM®jQhj<]r(jZX@Set the verbosity level (0-3). The normal level is 1; a missing r…r}r(jAX@Set the verbosity level (0-3). The normal level is 1; a missing jCNjPNjQhjBjubjµ)r}r(jAX*n*jG}r (jI]jJ]jK]jL]jN]ujBjj<]r jZXn…r }r (jAUjBjubajEj½ubjZX defaults to 2.r …r}r(jAX defaults to 2.jCNjPNjQhjBjubeubjq)r}r(jAXÅThere is also an extended version of this command which can be used to fine-tune the verbosity of output. It takes the form ``[silent|normal|verbose|debug]``\ *flags*, where *flags* is a list of ``+`` flags which toggle various aspects of output. At the moment, only ``+callsite`` and ``+callstack`` are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)jBjüjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM±jQhj<]r(jZX}There is also an extended version of this command which can be used to fine-tune the verbosity of output. It takes the form r…r}r(jAX}There is also an extended version of this command which can be used to fine-tune the verbosity of output. It takes the form jCNjPNjQhjBjubjz)r}r(jAX!``[silent|normal|verbose|debug]``jG}r(jI]jJ]jK]jL]jN]ujBjj<]rjZX[silent|normal|verbose|debug]r…r}r(jAUjBjubajEj‚ubjZX…r}r(jAX\ jCNjPNjQhjBjubjµ)r }r!(jAX*flags*jG}r"(jI]jJ]jK]jL]jN]ujBjj<]r#jZXflagsr$…r%}r&(jAUjBj ubajEj½ubjZX, where r'…r(}r)(jAX, where jCNjPNjQhjBjubjµ)r*}r+(jAX*flags*jG}r,(jI]jJ]jK]jL]jN]ujBjj<]r-jZXflagsr.…r/}r0(jAUjBj*ubajEj½ubjZX is a list of r1…r2}r3(jAX is a list of jCNjPNjQhjBjubjz)r4}r5(jAX``+``jG}r6(jI]jJ]jK]jL]jN]ujBjj<]r7jZX+…r8}r9(jAUjBj4ubajEj‚ubjZXD flags which toggle various aspects of output. At the moment, only r:…r;}r<(jAXD flags which toggle various aspects of output. At the moment, only jCNjPNjQhjBjubjz)r=}r>(jAX ``+callsite``jG}r?(jI]jJ]jK]jL]jN]ujBjj<]r@jZX +callsiterA…rB}rC(jAUjBj=ubajEj‚ubjZX and rD…rE}rF(jAX and jCNjPNjQhjBjubjz)rG}rH(jAX``+callstack``jG}rI(jI]jJ]jK]jL]jN]ujBjj<]rJjZX +callstackrK…rL}rM(jAUjBjGubajEj‚ubjZX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)rN…rO}rP(jAX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)jCNjPNjQhjBjubeubeubeubjq)rQ}rR(jAX£The various commands and the additional options they support are described below. In the simple build infrastructure, any other options will be reported as errors.rSjBj'jCjDjEjtjG}rT(jI]jJ]jK]jL]jN]ujPMºjQhj<]rUjZX£The various commands and the additional options they support are described below. In the simple build infrastructure, any other options will be reported as errors.rV…rW}rX(jAjSjCNjPNjQhjBjQubaubjÙ)rY}rZ(jAX.. _setup-configure:jBj'jCjDjEjÜjG}r[(jL]jK]jI]jJ]jN]jÞjujPM¾jQhj<]ubeubj>)r\}r](jAUU referencedr^KjBjßjCjDjá}r_hsjYsjEjFjG}r`(jI]jJ]jK]jL]ra(jjejN]rb(hhseujPMÁjQhjæ}rcjjYsj<]rd(jS)re}rf(jAXsetup configurergjBj\jCjDjEjWjG}rh(jI]jJ]jK]jL]jN]ujPMÁjQhj<]rijZXsetup configurerj…rk}rl(jAjgjCNjPNjQhjBjeubaubjq)rm}rn(jAXÁPrepare to build the package. Typically, this step checks that the target platform is capable of building the package, and discovers platform-specific features that are needed during the build.rojBj\jCjDjEjtjG}rp(jI]jJ]jK]jL]jN]ujPMÅjQhj<]rqjZXÁPrepare to build the package. Typically, this step checks that the target platform is capable of building the package, and discovers platform-specific features that are needed during the build.rr…rs}rt(jAjojCNjPNjQhjBjmubaubjq)ru}rv(jAXìThe user may also adjust the behaviour of later stages using the options listed in the following subsections. In the simple build infrastructure, the values supplied via these options are recorded in a private file read by later stages.rwjBj\jCjDjEjtjG}rx(jI]jJ]jK]jL]jN]ujPMÉjQhj<]ryjZXìThe user may also adjust the behaviour of later stages using the options listed in the following subsections. In the simple build infrastructure, the values supplied via these options are recorded in a private file read by later stages.rz…r{}r|(jAjwjCNjPNjQhjBjuubaubjq)r}}r~(jAXkIf a user-supplied ``configure`` script is run (see the section on `system-dependent parameters `__ or on `complex packages `__), it is passed the :option:`--with-hc-pkg`, :option:`--prefix`, :option:`--bindir`, :option:`--libdir`, :option:`--dynlibdir`, :option:`--datadir`, :option:`--libexecdir` and :option:`--sysconfdir` options. In addition the value of the :option:`--with-compiler` option is passed in a :option:`--with-hc-pkg` option and all options specified with :option:`--configure-option` are passed on.jBj\jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMÎjQhj<]r€(jZXIf a user-supplied r…r‚}rƒ(jAXIf a user-supplied jCNjPNjQhjBj}ubjz)r„}r…(jAX ``configure``jG}r†(jI]jJ]jK]jL]jN]ujBj}j<]r‡jZX configurerˆ…r‰}rŠ(jAUjBj„ubajEj‚ubjZX# script is run (see the section on r‹…rŒ}r(jAX# script is run (see the section on jCNjPNjQhjBj}ubj”)rŽ}r(jAXV`system-dependent parameters `__jG}r(UnameXsystem-dependent parametersjâX4developing-packages.html#system-dependent-parametersjL]jK]jI]jJ]jN]ujBj}j<]r‘jZXsystem-dependent parametersr’…r“}r”(jAUjBjŽubajEjubjZX or on r•…r–}r—(jAX or on jCNjPNjQhjBj}ubj”)r˜}r™(jAXE`complex packages `__jG}rš(UnameXcomplex packagesjâX.developing-packages.html#more-complex-packagesjL]jK]jI]jJ]jN]ujBj}j<]r›jZXcomplex packagesrœ…r}rž(jAUjBj˜ubajEjubjZX), it is passed the rŸ…r }r¡(jAX), it is passed the jCNjPNjQhjBj}ubj¥)r¢}r£(jAX:option:`--with-hc-pkg`r¤jBj}jCjDjEj©jG}r¥(UreftypeXoptionj«ˆj¬X --with-hc-pkgU refdomainXstdr¦jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°Xsetup-configurer§ujPMÎj<]r¨jz)r©}rª(jAj¤jG}r«(jI]jJ]r¬(j¶j¦X std-optionr­ejK]jL]jN]ujBj¢j<]r®jZX --with-hc-pkgr¯…r°}r±(jAUjBj©ubajEj‚ubaubjZX, r²…r³}r´(jAX, rµjCNjPNjQhjBj}ubj¥)r¶}r·(jAX:option:`--prefix`r¸jBj}jCjDjEj©jG}r¹(UreftypeXoptionj«ˆj¬X--prefixU refdomainXstdrºjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r»jz)r¼}r½(jAj¸jG}r¾(jI]jJ]r¿(j¶jºX std-optionrÀejK]jL]jN]ujBj¶j<]rÁjZX--prefixrÂ…rÃ}rÄ(jAUjBj¼ubajEj‚ubaubjZX, rÅ…rÆ}rÇ(jAX, jBj}ubj¥)rÈ}rÉ(jAX:option:`--bindir`rÊjBj}jCjDjEj©jG}rË(UreftypeXoptionj«ˆj¬X--bindirU refdomainXstdrÌjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]rÍjz)rÎ}rÏ(jAjÊjG}rÐ(jI]jJ]rÑ(j¶jÌX std-optionrÒejK]jL]jN]ujBjÈj<]rÓjZX--bindirrÔ…rÕ}rÖ(jAUjBjÎubajEj‚ubaubjZX, r×…rØ}rÙ(jAX, jCNjPNjQhjBj}ubj¥)rÚ}rÛ(jAX:option:`--libdir`rÜjBj}jCjDjEj©jG}rÝ(UreftypeXoptionj«ˆj¬X--libdirU refdomainXstdrÞjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]rßjz)rà}rá(jAjÜjG}râ(jI]jJ]rã(j¶jÞX std-optionräejK]jL]jN]ujBjÚj<]råjZX--libdirræ…rç}rè(jAUjBjàubajEj‚ubaubjZX, ré…rê}rë(jAX, jBj}ubj¥)rì}rí(jAX:option:`--dynlibdir`rîjBj}jCjDjEj©jG}rï(UreftypeXoptionj«ˆj¬X --dynlibdirU refdomainXstdrðjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]rñjz)rò}ró(jAjîjG}rô(jI]jJ]rõ(j¶jðX std-optionröejK]jL]jN]ujBjìj<]r÷jZX --dynlibdirrø…rù}rú(jAUjBjòubajEj‚ubaubjZX, rû…rü}rý(jAX, jBj}ubj¥)rþ}rÿ(jAX:option:`--datadir`r jBj}jCjDjEj©jG}r (UreftypeXoptionj«ˆj¬X --datadirU refdomainXstdr jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r jz)r }r (jAj jG}r (jI]jJ]r (j¶j X std-optionr ejK]jL]jN]ujBjþj<]r jZX --datadirr …r }r (jAUjBj ubajEj‚ubaubjZX, r …r }r (jAjµjBj}ubj¥)r }r (jAX:option:`--libexecdir`r jBj}jCjDjEj©jG}r (UreftypeXoptionj«ˆj¬X --libexecdirU refdomainXstdr jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r jz)r }r (jAj jG}r (jI]jJ]r (j¶j X std-optionr ejK]jL]jN]ujBj j<]r jZX --libexecdirr …r }r (jAUjBj ubajEj‚ubaubjZX and r …r }r! (jAX and jCNjPNjQhjBj}ubj¥)r" }r# (jAX:option:`--sysconfdir`r$ jBj}jCjDjEj©jG}r% (UreftypeXoptionj«ˆj¬X --sysconfdirU refdomainXstdr& jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r' jz)r( }r) (jAj$ jG}r* (jI]jJ]r+ (j¶j& X std-optionr, ejK]jL]jN]ujBj" j<]r- jZX --sysconfdirr. …r/ }r0 (jAUjBj( ubajEj‚ubaubjZX' options. In addition the value of the r1 …r2 }r3 (jAX' options. In addition the value of the jCNjPNjQhjBj}ubj¥)r4 }r5 (jAX:option:`--with-compiler`r6 jBj}jCjDjEj©jG}r7 (UreftypeXoptionj«ˆj¬X--with-compilerU refdomainXstdr8 jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r9 jz)r: }r; (jAj6 jG}r< (jI]jJ]r= (j¶j8 X std-optionr> ejK]jL]jN]ujBj4 j<]r? jZX--with-compilerr@ …rA }rB (jAUjBj: ubajEj‚ubaubjZX option is passed in a rC …rD }rE (jAX option is passed in a jCNjPNjQhjBj}ubj¥)rF }rG (jAX:option:`--with-hc-pkg`rH jBj}jCjDjEj©jG}rI (UreftypeXoptionj«ˆj¬X --with-hc-pkgU refdomainXstdrJ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]rK jz)rL }rM (jAjH jG}rN (jI]jJ]rO (j¶jJ X std-optionrP ejK]jL]jN]ujBjF j<]rQ jZX --with-hc-pkgrR …rS }rT (jAUjBjL ubajEj‚ubaubjZX' option and all options specified with rU …rV }rW (jAX' option and all options specified with jCNjPNjQhjBj}ubj¥)rX }rY (jAX:option:`--configure-option`rZ jBj}jCjDjEj©jG}r[ (UreftypeXoptionj«ˆj¬X--configure-optionU refdomainXstdr\ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÎj<]r] jz)r^ }r_ (jAjZ jG}r` (jI]jJ]ra (j¶j\ X std-optionrb ejK]jL]jN]ujBjX j<]rc jZX--configure-optionrd …re }rf (jAUjBj^ ubajEj‚ubaubjZX are passed on.rg …rh }ri (jAX are passed on.jCNjPNjQhjBj}ubeubjq)rj }rk (jAX}In Cabal 2.0, support for a single positional argument was added to ``setup configure`` This makes Cabal configure a the specific component to be configured. Specified names can be qualified with ``lib:`` or ``exe:`` in case just a name is ambiguous (as would be the case for a package named ``p`` which has a library and an executable named ``p``.) This has the following effects:jBj\jCjDjEjtjG}rl (jI]jJ]jK]jL]jN]ujPMÙjQhj<]rm (jZXDIn Cabal 2.0, support for a single positional argument was added to rn …ro }rp (jAXDIn Cabal 2.0, support for a single positional argument was added to jCNjPNjQhjBjj ubjz)rq }rr (jAX``setup configure``jG}rs (jI]jJ]jK]jL]jN]ujBjj j<]rt jZXsetup configureru …rv }rw (jAUjBjq ubajEj‚ubjZXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with rx …ry }rz (jAXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with jCNjPNjQhjBjj ubjz)r{ }r| (jAX``lib:``jG}r} (jI]jJ]jK]jL]jN]ujBjj j<]r~ jZXlib:r …r€ }r (jAUjBj{ ubajEj‚ubjZX or r‚ …rƒ }r„ (jAX or jCNjPNjQhjBjj ubjz)r… }r† (jAX``exe:``jG}r‡ (jI]jJ]jK]jL]jN]ujBjj j<]rˆ jZXexe:r‰ …rŠ }r‹ (jAUjBj… ubajEj‚ubjZXL in case just a name is ambiguous (as would be the case for a package named rŒ …r }rŽ (jAXL in case just a name is ambiguous (as would be the case for a package named jCNjPNjQhjBjj ubjz)r }r (jAX``p``jG}r‘ (jI]jJ]jK]jL]jN]ujBjj j<]r’ jZXp…r“ }r” (jAUjBj ubajEj‚ubjZX- which has a library and an executable named r• …r– }r— (jAX- which has a library and an executable named jCNjPNjQhjBjj ubjz)r˜ }r™ (jAX``p``jG}rš (jI]jJ]jK]jL]jN]ujBjj j<]r› jZXp…rœ }r (jAUjBj˜ ubajEj‚ubjZX".) This has the following effects:rž …rŸ }r  (jAX".) This has the following effects:jCNjPNjQhjBjj ubeubcdocutils.nodes bullet_list r¡ )r¢ }r£ (jAUjBj\jCjDjEU bullet_listr¤ jG}r¥ (Ubulletr¦ X-jL]jK]jI]jJ]jN]ujPMàjQhj<]r§ (cdocutils.nodes list_item r¨ )r© }rª (jAXhSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component. jBj¢ jCjDjEU list_itemr« jG}r¬ (jI]jJ]jK]jL]jN]ujPNjQhj<]r­ jq)r® }r¯ (jAXgSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component.jBj© jCjDjEjtjG}r° (jI]jJ]jK]jL]jN]ujPMàj<]r± (jZXSubsequent invocations of r² …r³ }r´ (jAXSubsequent invocations of jBj® ubjz)rµ }r¶ (jAX``cabal build``jG}r· (jI]jJ]jK]jL]jN]ujBj® j<]r¸ jZX cabal buildr¹ …rº }r» (jAUjBjµ ubajEj‚ubjZX, r¼ …r½ }r¾ (jAX, jBj® ubjz)r¿ }rÀ (jAX ``register``jG}rÁ (jI]jJ]jK]jL]jN]ujBj® j<]r jZXregisterrà …rÄ }rÅ (jAUjBj¿ ubajEj‚ubjZX0, etc. operate only on the configured component.rÆ …rÇ }rÈ (jAX0, etc. operate only on the configured component.jBj® ubeubaubj¨ )rÉ }rÊ (jAXðCabal requires all "internal" dependencies (e.g., an executable depending on a library defined in the same package) must be found in the set of databases via :option:`--package-db` (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using :option:`--dependency` simply by giving the name of the internal library; e.g., the dependency for an internal library named ``foo`` is given as ``--dependency=pkg-internal=pkg-1.0-internal-abcd``. jBj¢ jCjDjEj« jG}rË (jI]jJ]jK]jL]jN]ujPNjQhj<]rÌ jq)rÍ }rÎ (jAXïCabal requires all "internal" dependencies (e.g., an executable depending on a library defined in the same package) must be found in the set of databases via :option:`--package-db` (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using :option:`--dependency` simply by giving the name of the internal library; e.g., the dependency for an internal library named ``foo`` is given as ``--dependency=pkg-internal=pkg-1.0-internal-abcd``.jBjÉ jCjDjEjtjG}rÏ (jI]jJ]jK]jL]jN]ujPMãj<]rÐ (jZX¢Cabal requires all “internal†dependencies (e.g., an executable depending on a library defined in the same package) must be found in the set of databases via rÑ …rÒ }rÓ (jAXžCabal requires all "internal" dependencies (e.g., an executable depending on a library defined in the same package) must be found in the set of databases via jBjÍ ubj¥)rÔ }rÕ (jAX:option:`--package-db`rÖ jBjÍ jCjDjEj©jG}r× (UreftypeXoptionj«ˆj¬X --package-dbU refdomainXstdrØ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMãj<]rÙ jz)rÚ }rÛ (jAjÖ jG}rÜ (jI]jJ]rÝ (j¶jØ X std-optionrÞ ejK]jL]jN]ujBjÔ j<]rß jZX --package-dbrà …rá }râ (jAUjBjÚ ubajEj‚ubaubjZXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using rã …rä }rå (jAXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using jBjÍ ubj¥)ræ }rç (jAX:option:`--dependency`rè jBjÍ jCjDjEj©jG}ré (UreftypeXoptionj«ˆj¬X --dependencyU refdomainXstdrê jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMãj<]rë jz)rì }rí (jAjè jG}rî (jI]jJ]rï (j¶jê X std-optionrð ejK]jL]jN]ujBjæ j<]rñ jZX --dependencyrò …ró }rô (jAUjBjì ubajEj‚ubaubjZXg simply by giving the name of the internal library; e.g., the dependency for an internal library named rõ …rö }r÷ (jAXg simply by giving the name of the internal library; e.g., the dependency for an internal library named jBjÍ ubjz)rø }rù (jAX``foo``jG}rú (jI]jJ]jK]jL]jN]ujBjÍ j<]rû jZXfoorü …rý }rþ (jAUjBjø ubajEj‚ubjZX is given as rÿ …r }r (jAX is given as jBjÍ ubjz)r }r (jAX3``--dependency=pkg-internal=pkg-1.0-internal-abcd``jG}r (jI]jJ]jK]jL]jN]ujBjÍ j<]r jZX/--dependency=pkg-internal=pkg-1.0-internal-abcdr …r }r (jAUjBj ubajEj‚ubjZX.…r }r (jAX.jBjÍ ubeubaubj¨ )r }r (jAXOnly the dependencies needed for the requested component are required. Similarly, when :option:`--exact-configuration` is specified, it's only necessary to specify :option:`--dependency` for the component. (As mentioned previously, you *must* specify internal dependencies as well.) jBj¢ jCjDjEj« jG}r (jI]jJ]jK]jL]jN]ujPNjQhj<]r jq)r }r (jAXOnly the dependencies needed for the requested component are required. Similarly, when :option:`--exact-configuration` is specified, it's only necessary to specify :option:`--dependency` for the component. (As mentioned previously, you *must* specify internal dependencies as well.)jBj jCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPMìj<]r (jZXWOnly the dependencies needed for the requested component are required. Similarly, when r …r }r (jAXWOnly the dependencies needed for the requested component are required. Similarly, when jBj ubj¥)r }r (jAX:option:`--exact-configuration`r jBj jCjDjEj©jG}r (UreftypeXoptionj«ˆj¬X--exact-configurationU refdomainXstdr jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMìj<]r jz)r }r (jAj jG}r (jI]jJ]r (j¶j X std-optionr ejK]jL]jN]ujBj j<]r! jZX--exact-configurationr" …r# }r$ (jAUjBj ubajEj‚ubaubjZX0 is specified, it’s only necessary to specify r% …r& }r' (jAX. is specified, it's only necessary to specify jBj ubj¥)r( }r) (jAX:option:`--dependency`r* jBj jCjDjEj©jG}r+ (UreftypeXoptionj«ˆj¬X --dependencyU refdomainXstdr, jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMìj<]r- jz)r. }r/ (jAj* jG}r0 (jI]jJ]r1 (j¶j, X std-optionr2 ejK]jL]jN]ujBj( j<]r3 jZX --dependencyr4 …r5 }r6 (jAUjBj. ubajEj‚ubaubjZX2 for the component. (As mentioned previously, you r7 …r8 }r9 (jAX2 for the component. (As mentioned previously, you jBj ubjµ)r: }r; (jAX*must*jG}r< (jI]jJ]jK]jL]jN]ujBj j<]r= jZXmustr> …r? }r@ (jAUjBj: ubajEj½ubjZX( specify internal dependencies as well.)rA …rB }rC (jAX( specify internal dependencies as well.)jBj ubeubaubj¨ )rD }rE (jAXŽInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``. jBj¢ jCjDjEj« jG}rF (jI]jJ]jK]jL]jN]ujPNjQhj<]rG jq)rH }rI (jAXInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``.jBjD jCjDjEjtjG}rJ (jI]jJ]jK]jL]jN]ujPMòj<]rK (jZX Internal rL …rM }rN (jAX Internal jBjH ubjz)rO }rP (jAX``build-tool-depends``jG}rQ (jI]jJ]jK]jL]jN]ujBjH j<]rR jZXbuild-tool-dependsrS …rT }rU (jAUjBjO ubajEj‚ubjZX and rV …rW }rX (jAX and jBjH ubjz)rY }rZ (jAX``build-tools``jG}r[ (jI]jJ]jK]jL]jN]ujBjH j<]r\ jZX build-toolsr] …r^ }r_ (jAUjBjY ubajEj‚ubjZX( dependencies are expected to be in the r` …ra }rb (jAX( dependencies are expected to be in the jBjH ubjz)rc }rd (jAX``PATH``jG}re (jI]jJ]jK]jL]jN]ujBjH j<]rf jZXPATHrg …rh }ri (jAUjBjc ubajEj‚ubjZX upon subsequent invocations of rj …rk }rl (jAX upon subsequent invocations of jBjH ubjz)rm }rn (jAX ``setup``jG}ro (jI]jJ]jK]jL]jN]ujBjH j<]rp jZXsetuprq …rr }rs (jAUjBjm ubajEj‚ubjZX.…rt }ru (jAX.jBjH ubeubaubeubjq)rv }rw (jAXŸFull details can be found in the `Componentized Cabal proposal `__.jBj\jCjDjEjtjG}rx (jI]jJ]jK]jL]jN]ujPMõjQhj<]ry (jZX!Full details can be found in the rz …r{ }r| (jAX!Full details can be found in the jCNjPNjQhjBjv ubj”)r} }r~ (jAX}`Componentized Cabal proposal `__jG}r (UnameXComponentized Cabal proposaljâXZhttps://github.com/ezyang/ghc-proposals/blob/master/proposals/0000-componentized-cabal.rstjL]jK]jI]jJ]jN]ujBjv j<]r€ jZXComponentized Cabal proposalr …r‚ }rƒ (jAUjBj} ubajEjubjZX.…r„ }r… (jAX.jCNjPNjQhjBjv ubeubj>)r† }r‡ (jAUjBj\jCjDjEjFjG}rˆ (jI]jJ]jK]jL]r‰ háajN]rŠ h>aujPMùjQhj<]r‹ (jS)rŒ }r (jAXPrograms used for buildingrŽ jBj† jCjDjEjWjG}r (jI]jJ]jK]jL]jN]ujPMùjQhj<]r jZXPrograms used for buildingr‘ …r’ }r“ (jAjŽ jCNjPNjQhjBjŒ ubaubjq)r” }r• (jAXXThe following options govern the programs used to process the source files of a package:r– jBj† jCjDjEjtjG}r— (jI]jJ]jK]jL]jN]ujPMûjQhj<]r˜ jZXXThe following options govern the programs used to process the source files of a package:r™ …rš }r› (jAj– jCNjPNjQhjBj” ubaubjŠ)rœ }r (jAUjBj† jCjDjEjjG}rž (jL]jK]jI]jJ]jN]Uentries]rŸ (jXEsetup-configure command line option; --ghc or -g, --jhc, --lhc, --uhch¬UNtr  aujPNjQhj<]ubj’)r¡ }r¢ (jAUjBj† jCjDjEj•jG}r£ (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¤ j›j¤ ujPNjQhj<]r¥ (j)r¦ }r§ (jAX --ghc or -g, --jhc, --lhc, --uhcjBj¡ jCjDjEj jG}r¨ (j¢]r© (X--ghcrª X--jhcr« X--lhcr¬ X--uhcr­ ejL]r® h¬ajK]jI]jJ]jN]r¯ (h hhuhAej¨‰ujPMjQhj<]r° (jª)r± }r² (jAjª jBj¦ jCjDjEj­jG}r³ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r´ jZX--ghcrµ …r¶ }r· (jAUjCNjPNjQhjBj± ubaubj³)r¸ }r¹ (jAX or -gjBj¦ jCjDjEj¶jG}rº (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r» jZX or -gr¼ …r½ }r¾ (jAUjCNjPNjQhjBj¸ ubaubj³)r¿ }rÀ (jAjºjBj¦ jCjDjEj¶jG}rÁ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r jZX, rà …rÄ }rÅ (jAUjCNjPNjQhjBj¿ ubaubjª)rÆ }rÇ (jAj« jBj¦ jCjDjEj­jG}rÈ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rÉ jZX--jhcrÊ …rË }rÌ (jAUjCNjPNjQhjBjÆ ubaubj³)rÍ }rÎ (jAUjBj¦ jCjDjEj¶jG}rÏ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]ubj³)rÐ }rÑ (jAjºjBj¦ jCjDjEj¶jG}rÒ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rÓ jZX, rÔ …rÕ }rÖ (jAUjCNjPNjQhjBjÐ ubaubjª)r× }rØ (jAj¬ jBj¦ jCjDjEj­jG}rÙ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rÚ jZX--lhcrÛ …rÜ }rÝ (jAUjCNjPNjQhjBj× ubaubj³)rÞ }rß (jAUjBj¦ jCjDjEj¶jG}rà (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]ubj³)rá }râ (jAjºjBj¦ jCjDjEj¶jG}rã (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rä jZX, rå …ræ }rç (jAUjCNjPNjQhjBjá ubaubjª)rè }ré (jAj­ jBj¦ jCjDjEj­jG}rê (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rë jZX--uhcrì …rí }rî (jAUjCNjPNjQhjBjè ubaubj³)rï }rð (jAUjBj¦ jCjDjEj¶jG}rñ (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]ubeubjÎ)rò }ró (jAUjBj¡ jCjDjEjÑjG}rô (jI]jJ]jK]jL]jN]ujPMjQhj<]rõ jq)rö }r÷ (jAXÑSpecify which Haskell implementation to use to build the package. At most one of these flags may be given. If none is given, the implementation under which the setup script was compiled or interpreted is used.rø jBjò jCjDjEjtjG}rù (jI]jJ]jK]jL]jN]ujPMjQhj<]rú jZXÑSpecify which Haskell implementation to use to build the package. At most one of these flags may be given. If none is given, the implementation under which the setup script was compiled or interpreted is used.rû …rü }rý (jAjø jCNjPNjQhjBjö ubaubaubeubjŠ)rþ }rÿ (jAUjBj† jCjDjEjjG}r (jL]jK]jI]jJ]jN]Uentries]r (jXFsetup-configure command line option; --with-compiler=path or -w *path*hÇUNtr aujPNjQhj<]ubj’)r }r (jAUjBj† jCjDjEj•jG}r (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr j›j ujPNjQhj<]r (j)r }r (jAX!--with-compiler=path or -w *path*jBj jCjDjEj jG}r (j¢]r X--with-compilerr ajL]r hÇajK]jI]jJ]jN]r h$aj¨‰ujPMjQhj<]r (jª)r }r (jAj jBj jCjDjEj­jG}r (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r jZX--with-compilerr …r }r (jAUjCNjPNjQhjBj ubaubj³)r }r (jAX=path or -w *path*jBj jCjDjEj¶jG}r (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r jZX=path or -w *path*r …r }r (jAUjCNjPNjQhjBj ubaubeubjÎ)r }r (jAUjBj jCjDjEjÑjG}r (jI]jJ]jK]jL]jN]ujPMjQhj<]r! (jq)r" }r# (jAX³Specify the path to a particular compiler. If given, this must match the implementation selected above. The default is to search for the usual name of the selected implementation.r$ jBj jCjDjEjtjG}r% (jI]jJ]jK]jL]jN]ujPMjQhj<]r& jZX³Specify the path to a particular compiler. If given, this must match the implementation selected above. The default is to search for the usual name of the selected implementation.r' …r( }r) (jAj$ jCNjPNjQhjBj" ubaubjq)r* }r+ (jAXùThis flag also sets the default value of the :option:`--with-hc-pkg` option to the package tool for this compiler. Check the output of ``setup configure -v`` to ensure that it finds the right package tool (or use :option:`--with-hc-pkg` explicitly).jBj jCjDjEjtjG}r, (jI]jJ]jK]jL]jN]ujPM jQhj<]r- (jZX-This flag also sets the default value of the r. …r/ }r0 (jAX-This flag also sets the default value of the jCNjPNjQhjBj* ubj¥)r1 }r2 (jAX:option:`--with-hc-pkg`r3 jBj* jCjDjEj©jG}r4 (UreftypeXoptionj«ˆj¬X --with-hc-pkgU refdomainXstdr5 jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM j<]r6 jz)r7 }r8 (jAj3 jG}r9 (jI]jJ]r: (j¶j5 X std-optionr; ejK]jL]jN]ujBj1 j<]r< jZX --with-hc-pkgr= …r> }r? (jAUjBj7 ubajEj‚ubaubjZXC option to the package tool for this compiler. Check the output of r@ …rA }rB (jAXC option to the package tool for this compiler. Check the output of jCNjPNjQhjBj* ubjz)rC }rD (jAX``setup configure -v``jG}rE (jI]jJ]jK]jL]jN]ujBj* j<]rF jZXsetup configure -vrG …rH }rI (jAUjBjC ubajEj‚ubjZX8 to ensure that it finds the right package tool (or use rJ …rK }rL (jAX8 to ensure that it finds the right package tool (or use jCNjPNjQhjBj* ubj¥)rM }rN (jAX:option:`--with-hc-pkg`rO jBj* jCjDjEj©jG}rP (UreftypeXoptionj«ˆj¬X --with-hc-pkgU refdomainXstdrQ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM j<]rR jz)rS }rT (jAjO jG}rU (jI]jJ]rV (j¶jQ X std-optionrW ejK]jL]jN]ujBjM j<]rX jZX --with-hc-pkgrY …rZ }r[ (jAUjBjS ubajEj‚ubaubjZX explicitly).r\ …r] }r^ (jAX explicitly).jCNjPNjQhjBj* ubeubeubeubjŠ)r_ }r` (jAUjBj† jCjDjEjjG}ra (jL]jK]jI]jJ]jN]Uentries]rb (jX7setup-configure command line option; --with-hc-pkg=pathhÉUNtrc aujPNjQhj<]ubj’)rd }re (jAUjBj† jCjDjEj•jG}rf (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrg j›jg ujPNjQhj<]rh (j)ri }rj (jAX--with-hc-pkg=pathjBjd jCjDjEj jG}rk (j¢]rl X --with-hc-pkgrm ajL]rn hÉajK]jI]jJ]jN]ro h&aj¨‰ujPMjQhj<]rp (jª)rq }rr (jAjm jBji jCjDjEj­jG}rs (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rt jZX --with-hc-pkgru …rv }rw (jAUjCNjPNjQhjBjq ubaubj³)rx }ry (jAX=pathjBji jCjDjEj¶jG}rz (jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r{ jZX=pathr| …r} }r~ (jAUjCNjPNjQhjBjx ubaubeubjÎ)r }r€ (jAUjBjd jCjDjEjÑjG}r (jI]jJ]jK]jL]jN]ujPMjQhj<]r‚ jq)rƒ }r„ (jAXìSpecify the path to the package tool, e.g. ``ghc-pkg``. The package tool must be compatible with the compiler specified by :option:`--with-compiler`. If this option is omitted, the default value is determined from the compiler selected.jBj jCjDjEjtjG}r… (jI]jJ]jK]jL]jN]ujPMjQhj<]r† (jZX+Specify the path to the package tool, e.g. r‡ …rˆ }r‰ (jAX+Specify the path to the package tool, e.g. jCNjPNjQhjBjƒ ubjz)rŠ }r‹ (jAX ``ghc-pkg``jG}rŒ (jI]jJ]jK]jL]jN]ujBjƒ j<]r jZXghc-pkgrŽ …r }r (jAUjBjŠ ubajEj‚ubjZXE. The package tool must be compatible with the compiler specified by r‘ …r’ }r“ (jAXE. The package tool must be compatible with the compiler specified by jCNjPNjQhjBjƒ ubj¥)r” }r• (jAX:option:`--with-compiler`r– jBjƒ jCjDjEj©jG}r— (UreftypeXoptionj«ˆj¬X--with-compilerU refdomainXstdr˜ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]r™ jz)rš }r› (jAj– jG}rœ (jI]jJ]r (j¶j˜ X std-optionrž ejK]jL]jN]ujBj” j<]rŸ jZX--with-compilerr  …r¡ }r¢ (jAUjBjš ubajEj‚ubaubjZXX. If this option is omitted, the default value is determined from the compiler selected.r£ …r¤ }r¥ (jAXX. If this option is omitted, the default value is determined from the compiler selected.jCNjPNjQhjBjƒ ubeubaubeubjŠ)r¦ }r§ (jAUjBj† jCjDjEjjG}r¨ (jL]jK]jI]jJ]jN]Uentries]r© (jX5setup-configure command line option; --with-prog=pathj(UNtrª aujPNjQhj<]ubj’)r« }r¬ (jAUjBj† jCjDjEj•jG}r­ (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr® j›j® ujPNjQhj<]r¯ (j)r° }r± (jAX--with-prog=pathjBj« jCjDjEj jG}r² (j¢]r³ X --with-progr´ ajL]rµ j(ajK]jI]jJ]jN]r¶ h‹aj¨‰ujPM jQhj<]r· (jª)r¸ }r¹ (jAj´ jBj° jCjDjEj­jG}rº (jµj¶jL]jK]jI]jJ]jN]ujPM jQhj<]r» jZX --with-progr¼ …r½ }r¾ (jAUjCNjPNjQhjBj¸ ubaubj³)r¿ }rÀ (jAX=pathjBj° jCjDjEj¶jG}rÁ (jµj¶jL]jK]jI]jJ]jN]ujPM jQhj<]r jZX=pathrà …rÄ }rÅ (jAUjCNjPNjQhjBj¿ ubaubeubjÎ)rÆ }rÇ (jAUjBj« jCjDjEjÑjG}rÈ (jI]jJ]jK]jL]jN]ujPM jQhj<]rÉ jq)rÊ }rË (jAX—Specify the path to the program *prog*. Any program known to Cabal can be used in place of *prog*. It can either be a fully path or the name of a program that can be found on the program search path. For example: ``--with-ghc=ghc-6.6.1`` or ``--with-cpphs=/usr/local/bin/cpphs``. The full list of accepted programs is not enumerated in this user guide. Rather, run ``cabal install --help`` to view the list.jBjÆ jCjDjEjtjG}rÌ (jI]jJ]jK]jL]jN]ujPMjQhj<]rÍ (jZX Specify the path to the program rÎ …rÏ }rÐ (jAX Specify the path to the program jCNjPNjQhjBjÊ ubjµ)rÑ }rÒ (jAX*prog*jG}rÓ (jI]jJ]jK]jL]jN]ujBjÊ j<]rÔ jZXprogrÕ …rÖ }r× (jAUjBjÑ ubajEj½ubjZX5. Any program known to Cabal can be used in place of rØ …rÙ }rÚ (jAX5. Any program known to Cabal can be used in place of jCNjPNjQhjBjÊ ubjµ)rÛ }rÜ (jAX*prog*jG}rÝ (jI]jJ]jK]jL]jN]ujBjÊ j<]rÞ jZXprogrß …rà }rá (jAUjBjÛ ubajEj½ubjZXt. It can either be a fully path or the name of a program that can be found on the program search path. For example: râ …rã }rä (jAXt. It can either be a fully path or the name of a program that can be found on the program search path. For example: jCNjPNjQhjBjÊ ubjz)rå }ræ (jAX``--with-ghc=ghc-6.6.1``jG}rç (jI]jJ]jK]jL]jN]ujBjÊ j<]rè jZX--with-ghc=ghc-6.6.1ré …rê }rë (jAUjBjå ubajEj‚ubjZX or rì …rí }rî (jAX or jCNjPNjQhjBjÊ ubjz)rï }rð (jAX%``--with-cpphs=/usr/local/bin/cpphs``jG}rñ (jI]jJ]jK]jL]jN]ujBjÊ j<]rò jZX!--with-cpphs=/usr/local/bin/cpphsró …rô }rõ (jAUjBjï ubajEj‚ubjZXW. The full list of accepted programs is not enumerated in this user guide. Rather, run rö …r÷ }rø (jAXW. The full list of accepted programs is not enumerated in this user guide. Rather, run jCNjPNjQhjBjÊ ubjz)rù }rú (jAX``cabal install --help``jG}rû (jI]jJ]jK]jL]jN]ujBjÊ j<]rü jZXcabal install --helprý …rþ }rÿ (jAUjBjù ubajEj‚ubjZX to view the list.r …r }r (jAX to view the list.jCNjPNjQhjBjÊ ubeubaubeubjŠ)r }r (jAUjBj† jCjDjEjjG}r (jL]jK]jI]jJ]jN]Uentries]r (jX;setup-configure command line option; --prog-options=optionsjUNtr aujPNjQhj<]ubj’)r }r (jAUjBj† jCjDjEj•jG}r (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr j›j ujPNjQhj<]r (j)r }r (jAX--prog-options=optionsjBj jCjDjEj jG}r (j¢]r X--prog-optionsr ajL]r jajK]jI]jJ]jN]r htaj¨‰ujPM+jQhj<]r (jª)r }r (jAj jBj jCjDjEj­jG}r (jµj¶jL]jK]jI]jJ]jN]ujPM+jQhj<]r jZX--prog-optionsr …r }r (jAUjCNjPNjQhjBj ubaubj³)r }r (jAX=optionsjBj jCjDjEj¶jG}r (jµj¶jL]jK]jI]jJ]jN]ujPM+jQhj<]r jZX=optionsr …r! }r" (jAUjCNjPNjQhjBj ubaubeubjÎ)r# }r$ (jAUjBj jCjDjEjÑjG}r% (jI]jJ]jK]jL]jN]ujPM+jQhj<]r& jq)r' }r( (jAX×Specify additional options to the program *prog*. Any program known to Cabal can be used in place of *prog*. For example: ``--alex-options="--template=mytemplatedir/"``. The *options* is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example ``--foo-options='--bar="C:\Program File\Bar"'``. As an alternative that takes only one option at a time but avoids the need to quote, use :option:`--prog-option` instead.jBj# jCjDjEjtjG}r) (jI]jJ]jK]jL]jN]ujPM#jQhj<]r* (jZX*Specify additional options to the program r+ …r, }r- (jAX*Specify additional options to the program jCNjPNjQhjBj' ubjµ)r. }r/ (jAX*prog*jG}r0 (jI]jJ]jK]jL]jN]ujBj' j<]r1 jZXprogr2 …r3 }r4 (jAUjBj. ubajEj½ubjZX5. Any program known to Cabal can be used in place of r5 …r6 }r7 (jAX5. Any program known to Cabal can be used in place of jCNjPNjQhjBj' ubjµ)r8 }r9 (jAX*prog*jG}r: (jI]jJ]jK]jL]jN]ujBj' j<]r; jZXprogr< …r= }r> (jAUjBj8 ubajEj½ubjZX. For example: r? …r@ }rA (jAX. For example: jCNjPNjQhjBj' ubjz)rB }rC (jAX.``--alex-options="--template=mytemplatedir/"``jG}rD (jI]jJ]jK]jL]jN]ujBj' j<]rE jZX*--alex-options="--template=mytemplatedir/"rF …rG }rH (jAUjBjB ubajEj‚ubjZX. The rI …rJ }rK (jAX. The jCNjPNjQhjBj' ubjµ)rL }rM (jAX *options*jG}rN (jI]jJ]jK]jL]jN]ujBj' j<]rO jZXoptionsrP …rQ }rR (jAUjBjL ubajEj½ubjZXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example rS …rT }rU (jAXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example jCNjPNjQhjBj' ubjz)rV }rW (jAX/``--foo-options='--bar="C:\Program File\Bar"'``jG}rX (jI]jJ]jK]jL]jN]ujBj' j<]rY jZX+--foo-options='--bar="C:\Program File\Bar"'rZ …r[ }r\ (jAUjBjV ubajEj‚ubjZX[. As an alternative that takes only one option at a time but avoids the need to quote, use r] …r^ }r_ (jAX[. As an alternative that takes only one option at a time but avoids the need to quote, use jCNjPNjQhjBj' ubj¥)r` }ra (jAX:option:`--prog-option`rb jBj' jCjDjEj©jG}rc (UreftypeXoptionj«ˆj¬X --prog-optionU refdomainXstdrd jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM#j<]re jz)rf }rg (jAjb jG}rh (jI]jJ]ri (j¶jd X std-optionrj ejK]jL]jN]ujBj` j<]rk jZX --prog-optionrl …rm }rn (jAUjBjf ubajEj‚ubaubjZX instead.ro …rp }rq (jAX instead.jCNjPNjQhjBj' ubeubaubeubjŠ)rr }rs (jAUjBj† jCjDjEjjG}rt (jL]jK]jI]jJ]jN]Uentries]ru (jX9setup-configure command line option; --prog-option=optionj UNtrv aujPNjQhj<]ubj’)rw }rx (jAUjBj† jCjDjEj•jG}ry (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrz j›jz ujPNjQhj<]r{ (j)r| }r} (jAX--prog-option=optionjBjw jCjDjEj jG}r~ (j¢]r X --prog-optionr€ ajL]r j ajK]jI]jJ]jN]r‚ hhaj¨‰ujPM4jQhj<]rƒ (jª)r„ }r… (jAj€ jBj| jCjDjEj­jG}r† (jµj¶jL]jK]jI]jJ]jN]ujPM4jQhj<]r‡ jZX --prog-optionrˆ …r‰ }rŠ (jAUjCNjPNjQhjBj„ ubaubj³)r‹ }rŒ (jAX=optionjBj| jCjDjEj¶jG}r (jµj¶jL]jK]jI]jJ]jN]ujPM4jQhj<]rŽ jZX=optionr …r }r‘ (jAUjCNjPNjQhjBj‹ ubaubeubjÎ)r’ }r“ (jAUjBjw jCjDjEjÑjG}r” (jI]jJ]jK]jL]jN]ujPM4jQhj<]r• jq)r– }r— (jAX€Specify a single additional option to the program *prog*. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than :option:`--prog-options` means you do not need an additional level of quoting. Of course if you are using a command shell you may still need to quote, for example ``--foo-options="--bar=C:\Program File\Bar"``.jBj’ jCjDjEjtjG}r˜ (jI]jJ]jK]jL]jN]ujPM.jQhj<]r™ (jZX2Specify a single additional option to the program rš …r› }rœ (jAX2Specify a single additional option to the program jCNjPNjQhjBj– ubjµ)r }rž (jAX*prog*jG}rŸ (jI]jJ]jK]jL]jN]ujBj– j<]r  jZXprogr¡ …r¢ }r£ (jAUjBj ubajEj½ubjZXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than r¤ …r¥ }r¦ (jAXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than jCNjPNjQhjBj– ubj¥)r§ }r¨ (jAX:option:`--prog-options`r© jBj– jCjDjEj©jG}rª (UreftypeXoptionj«ˆj¬X--prog-optionsU refdomainXstdr« jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM.j<]r¬ jz)r­ }r® (jAj© jG}r¯ (jI]jJ]r° (j¶j« X std-optionr± ejK]jL]jN]ujBj§ j<]r² jZX--prog-optionsr³ …r´ }rµ (jAUjBj­ ubajEj‚ubaubjZX‹ means you do not need an additional level of quoting. Of course if you are using a command shell you may still need to quote, for example r¶ …r· }r¸ (jAX‹ means you do not need an additional level of quoting. Of course if you are using a command shell you may still need to quote, for example jCNjPNjQhjBj– ubjz)r¹ }rº (jAX-``--foo-options="--bar=C:\Program File\Bar"``jG}r» (jI]jJ]jK]jL]jN]ujBj– j<]r¼ jZX)--foo-options="--bar=C:\Program File\Bar"r½ …r¾ }r¿ (jAUjBj¹ ubajEj‚ubjZX.…rÀ }rÁ (jAX.jCNjPNjQhjBj– ubeubaubeubjq)r }rà (jAX¤All of the options passed with either :option:`--prog-options` or :option:`--prog-option` are passed in the order they were specified on the configure command line.jBj† jCjDjEjtjG}rÄ (jI]jJ]jK]jL]jN]ujPM5jQhj<]rÅ (jZX&All of the options passed with either rÆ …rÇ }rÈ (jAX&All of the options passed with either jCNjPNjQhjBj ubj¥)rÉ }rÊ (jAX:option:`--prog-options`rË jBj jCjDjEj©jG}rÌ (UreftypeXoptionj«ˆj¬X--prog-optionsU refdomainXstdrÍ jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM5j<]rÎ jz)rÏ }rÐ (jAjË jG}rÑ (jI]jJ]rÒ (j¶jÍ X std-optionrÓ ejK]jL]jN]ujBjÉ j<]rÔ jZX--prog-optionsrÕ …rÖ }r× (jAUjBjÏ ubajEj‚ubaubjZX or rØ …rÙ }rÚ (jAX or jCNjPNjQhjBj ubj¥)rÛ }rÜ (jAX:option:`--prog-option`rÝ jBj jCjDjEj©jG}rÞ (UreftypeXoptionj«ˆj¬X --prog-optionU refdomainXstdrß jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM5j<]rà jz)rá }râ (jAjÝ jG}rã (jI]jJ]rä (j¶jß X std-optionrå ejK]jL]jN]ujBjÛ j<]ræ jZX --prog-optionrç …rè }ré (jAUjBjá ubajEj‚ubaubjZXK are passed in the order they were specified on the configure command line.rê …rë }rì (jAXK are passed in the order they were specified on the configure command line.jCNjPNjQhjBj ubeubeubj>)rí }rî (jAUjBj\jCjDjEjFjG}rï (jI]jJ]jK]jL]rð hþajN]rñ h\aujPM:jQhj<]rò (jS)ró }rô (jAXInstallation pathsrõ jBjí jCjDjEjWjG}rö (jI]jJ]jK]jL]jN]ujPM:jQhj<]r÷ jZXInstallation pathsrø …rù }rú (jAjõ jCNjPNjQhjBjó ubaubjq)rû }rü (jAXLThe following options govern the location of installed files from a package:rý jBjí jCjDjEjtjG}rþ (jI]jJ]jK]jL]jN]ujPM<jQhj<]rÿ jZXLThe following options govern the location of installed files from a package:r …r }r (jAjý jCNjPNjQhjBjû ubaubjŠ)r }r (jAUjBjí jCjDjEjjG}r (jL]jK]jI]jJ]jN]Uentries]r (jX1setup-configure command line option; --prefix=dirj-UNtr aujPNjQhj<]ubj’)r }r (jAUjBjí jCjDjEj•jG}r (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr j›j ujPNjQhj<]r (j)r }r (jAX --prefix=dirjBj jCjDjEj jG}r (j¢]r X--prefixr ajL]r j-ajK]jI]jJ]jN]r h‘aj¨‰ujPMIjQhj<]r (jª)r }r (jAj jBj jCjDjEj­jG}r (jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]r jZX--prefixr …r }r (jAUjCNjPNjQhjBj ubaubj³)r }r (jAX=dirjBj jCjDjEj¶jG}r (jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]r jZX=dirr …r! }r" (jAUjCNjPNjQhjBj ubaubeubjÎ)r# }r$ (jAUjBj jCjDjEjÑjG}r% (jI]jJ]jK]jL]jN]ujPMIjQhj<]r& (jq)r' }r( (jAXúThe root of the installation. For example for a global install you might use ``/usr/local`` on a Unix system, or ``C:\Program Files`` on a Windows system. The other installation paths are usually subdirectories of *prefix*, but they don't have to be.jBj# jCjDjEjtjG}r) (jI]jJ]jK]jL]jN]ujPMAjQhj<]r* (jZXMThe root of the installation. For example for a global install you might use r+ …r, }r- (jAXMThe root of the installation. For example for a global install you might use jCNjPNjQhjBj' ubjz)r. }r/ (jAX``/usr/local``jG}r0 (jI]jJ]jK]jL]jN]ujBj' j<]r1 jZX /usr/localr2 …r3 }r4 (jAUjBj. ubajEj‚ubjZX on a Unix system, or r5 …r6 }r7 (jAX on a Unix system, or jCNjPNjQhjBj' ubjz)r8 }r9 (jAX``C:\Program Files``jG}r: (jI]jJ]jK]jL]jN]ujBj' j<]r; jZXC:\Program Filesr< …r= }r> (jAUjBj8 ubajEj‚ubjZXQ on a Windows system. The other installation paths are usually subdirectories of r? …r@ }rA (jAXQ on a Windows system. The other installation paths are usually subdirectories of jCNjPNjQhjBj' ubjµ)rB }rC (jAX*prefix*jG}rD (jI]jJ]jK]jL]jN]ujBj' j<]rE jZXprefixrF …rG }rH (jAUjBjB ubajEj½ubjZX, but they don’t have to be.rI …rJ }rK (jAX, but they don't have to be.jCNjPNjQhjBj' ubeubjq)rL }rM (jAX¨In the simple build system, *dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj# jCjDjEjtjG}rN (jI]jJ]jK]jL]jN]ujPMFjQhj<]rO (jZXIn the simple build system, rP …rQ }rR (jAXIn the simple build system, jCNjPNjQhjBjL ubjµ)rS }rT (jAX*dir*jG}rU (jI]jJ]jK]jL]jN]ujBjL j<]rV jZXdirrW …rX }rY (jAUjBjS ubajEj½ubjZX+ may contain the following path variables: rZ …r[ }r\ (jAX+ may contain the following path variables: jCNjPNjQhjBjL ubjz)r] }r^ (jAX ``$pkgid``jG}r_ (jI]jJ]jK]jL]jN]ujBjL j<]r` jZX$pkgidra …rb }rc (jAUjBj] ubajEj‚ubjZX, rd …re }rf (jAX, rg jCNjPNjQhjBjL ubjz)rh }ri (jAX``$pkg``jG}rj (jI]jJ]jK]jL]jN]ujBjL j<]rk jZX$pkgrl …rm }rn (jAUjBjh ubajEj‚ubjZX, ro …rp }rq (jAX, jBjL ubjz)rr }rs (jAX ``$version``jG}rt (jI]jJ]jK]jL]jN]ujBjL j<]ru jZX$versionrv …rw }rx (jAUjBjr ubajEj‚ubjZX, ry …rz }r{ (jAX, jBjL ubjz)r| }r} (jAX ``$compiler``jG}r~ (jI]jJ]jK]jL]jN]ujBjL j<]r jZX $compilerr€ …r }r‚ (jAUjBj| ubajEj‚ubjZX, rƒ …r„ }r… (jAX, jCNjPNjQhjBjL ubjz)r† }r‡ (jAX``$os``jG}rˆ (jI]jJ]jK]jL]jN]ujBjL j<]r‰ jZX$osrŠ …r‹ }rŒ (jAUjBj† ubajEj‚ubjZX, r …rŽ }r (jAX, jBjL ubjz)r }r‘ (jAX ``$arch``jG}r’ (jI]jJ]jK]jL]jN]ujBjL j<]r“ jZX$archr” …r• }r– (jAUjBj ubajEj‚ubjZX, r— …r˜ }r™ (jAX, jBjL ubjz)rš }r› (jAX``$abi``jG}rœ (jI]jJ]jK]jL]jN]ujBjL j<]r jZX$abirž …rŸ }r  (jAUjBjš ubajEj‚ubjZX, r¡ …r¢ }r£ (jAjg jBjL ubjz)r¤ }r¥ (jAX ``$abitag``jG}r¦ (jI]jJ]jK]jL]jN]ujBjL j<]r§ jZX$abitagr¨ …r© }rª (jAUjBj¤ ubajEj‚ubeubeubeubjŠ)r« }r¬ (jAUjBjí jCjDjEjjG}r­ (jL]jK]jI]jJ]jN]Uentries]r® (jX1setup-configure command line option; --bindir=dirhÓUNtr¯ aujPNjQhj<]ubj’)r° }r± (jAUjBjí jCjDjEj•jG}r² (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr³ j›j³ ujPNjQhj<]r´ (j)rµ }r¶ (jAX --bindir=dirjBj° jCjDjEj jG}r· (j¢]r¸ X--bindirr¹ ajL]rº hÓajK]jI]jJ]jN]r» h0aj¨‰ujPMQjQhj<]r¼ (jª)r½ }r¾ (jAj¹ jBjµ jCjDjEj­jG}r¿ (jµj¶jL]jK]jI]jJ]jN]ujPMQjQhj<]rÀ jZX--bindirrÁ …r }rà (jAUjCNjPNjQhjBj½ ubaubj³)rÄ }rÅ (jAX=dirjBjµ jCjDjEj¶jG}rÆ (jµj¶jL]jK]jI]jJ]jN]ujPMQjQhj<]rÇ jZX=dirrÈ …rÉ }rÊ (jAUjCNjPNjQhjBjÄ ubaubeubjÎ)rË }rÌ (jAUjBj° jCjDjEjÑjG}rÍ (jI]jJ]jK]jL]jN]ujPMQjQhj<]rÎ (jq)rÏ }rÐ (jAX:Executables that the user might invoke are installed here.rÑ jBjË jCjDjEjtjG}rÒ (jI]jJ]jK]jL]jN]ujPMLjQhj<]rÓ jZX:Executables that the user might invoke are installed here.rÔ …rÕ }rÖ (jAjÑ jCNjPNjQhjBjÏ ubaubjq)r× }rØ (jAXµIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjË jCjDjEjtjG}rÙ (jI]jJ]jK]jL]jN]ujPMNjQhj<]rÚ (jZXIn the simple build system, rÛ …rÜ }rÝ (jAXIn the simple build system, jCNjPNjQhjBj× ubjµ)rÞ }rß (jAX*dir*jG}rà (jI]jJ]jK]jL]jN]ujBj× j<]rá jZXdirrâ …rã }rä (jAUjBjÞ ubajEj½ubjZX+ may contain the following path variables: rå …ræ }rç (jAX+ may contain the following path variables: jCNjPNjQhjBj× ubjz)rè }ré (jAX ``$prefix``jG}rê (jI]jJ]jK]jL]jN]ujBj× j<]rë jZX$prefixrì …rí }rî (jAUjBjè ubajEj‚ubjZX, rï …rð }rñ (jAX, rò jCNjPNjQhjBj× ubjz)ró }rô (jAX ``$pkgid``jG}rõ (jI]jJ]jK]jL]jN]ujBj× j<]rö jZX$pkgidr÷ …rø }rù (jAUjBjó ubajEj‚ubjZX, rú …rû }rü (jAX, jBj× ubjz)rý }rþ (jAX``$pkg``jG}rÿ (jI]jJ]jK]jL]jN]ujBj× j<]rjZX$pkgr…r}r(jAUjBjý ubajEj‚ubjZX, r…r}r(jAX, jBj× ubjz)r}r(jAX ``$version``jG}r (jI]jJ]jK]jL]jN]ujBj× j<]r jZX$versionr …r }r (jAUjBjubajEj‚ubjZX, r…r}r(jAX, jCNjPNjQhjBj× ubjz)r}r(jAX ``$compiler``jG}r(jI]jJ]jK]jL]jN]ujBj× j<]rjZX $compilerr…r}r(jAUjBjubajEj‚ubjZX, r…r}r(jAX, jBj× ubjz)r}r(jAX``$os``jG}r(jI]jJ]jK]jL]jN]ujBj× j<]rjZX$osr…r }r!(jAUjBjubajEj‚ubjZX, r"…r#}r$(jAX, jBj× ubjz)r%}r&(jAX ``$arch``jG}r'(jI]jJ]jK]jL]jN]ujBj× j<]r(jZX$archr)…r*}r+(jAUjBj%ubajEj‚ubjZX, r,…r-}r.(jAX, jBj× ubjz)r/}r0(jAX``$abi``jG}r1(jI]jJ]jK]jL]jN]ujBj× j<]r2jZX$abir3…r4}r5(jAUjBj/ubajEj‚ubjZX, r6…r7}r8(jAjò jBj× ubjz)r9}r:(jAX ``$abitag``jG}r;(jI]jJ]jK]jL]jN]ujBj× j<]r<jZX$abitagr=…r>}r?(jAUjBj9ubajEj‚ubeubeubeubjŠ)r@}rA(jAUjBjí jCjDjEjjG}rB(jL]jK]jI]jJ]jN]Uentries]rC(jX1setup-configure command line option; --libdir=dirhÎUNtrDaujPNjQhj<]ubj’)rE}rF(jAUjBjí jCjDjEj•jG}rG(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrHj›jHujPNjQhj<]rI(j)rJ}rK(jAX --libdir=dirjBjEjCjDjEj jG}rL(j¢]rMX--libdirrNajL]rOhÎajK]jI]jJ]jN]rPh+aj¨‰ujPMZjQhj<]rQ(jª)rR}rS(jAjNjBjJjCjDjEj­jG}rT(jµj¶jL]jK]jI]jJ]jN]ujPMZjQhj<]rUjZX--libdirrV…rW}rX(jAUjCNjPNjQhjBjRubaubj³)rY}rZ(jAX=dirjBjJjCjDjEj¶jG}r[(jµj¶jL]jK]jI]jJ]jN]ujPMZjQhj<]r\jZX=dirr]…r^}r_(jAUjCNjPNjQhjBjYubaubeubjÎ)r`}ra(jAUjBjEjCjDjEjÑjG}rb(jI]jJ]jK]jL]jN]ujPMZjQhj<]rc(jq)rd}re(jAX)Object-code libraries are installed here.rfjBj`jCjDjEjtjG}rg(jI]jJ]jK]jL]jN]ujPMTjQhj<]rhjZX)Object-code libraries are installed here.ri…rj}rk(jAjfjCNjPNjQhjBjdubaubjq)rl}rm(jAXÂIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj`jCjDjEjtjG}rn(jI]jJ]jK]jL]jN]ujPMVjQhj<]ro(jZXIn the simple build system, rp…rq}rr(jAXIn the simple build system, jCNjPNjQhjBjlubjµ)rs}rt(jAX*dir*jG}ru(jI]jJ]jK]jL]jN]ujBjlj<]rvjZXdirrw…rx}ry(jAUjBjsubajEj½ubjZX+ may contain the following path variables: rz…r{}r|(jAX+ may contain the following path variables: jCNjPNjQhjBjlubjz)r}}r~(jAX ``$prefix``jG}r(jI]jJ]jK]jL]jN]ujBjlj<]r€jZX$prefixr…r‚}rƒ(jAUjBj}ubajEj‚ubjZX, r„…r…}r†(jAX, r‡jCNjPNjQhjBjlubjz)rˆ}r‰(jAX ``$bindir``jG}rŠ(jI]jJ]jK]jL]jN]ujBjlj<]r‹jZX$bindirrŒ…r}rŽ(jAUjBjˆubajEj‚ubjZX, r…r}r‘(jAX, jBjlubjz)r’}r“(jAX ``$pkgid``jG}r”(jI]jJ]jK]jL]jN]ujBjlj<]r•jZX$pkgidr–…r—}r˜(jAUjBj’ubajEj‚ubjZX, r™…rš}r›(jAX, jBjlubjz)rœ}r(jAX``$pkg``jG}rž(jI]jJ]jK]jL]jN]ujBjlj<]rŸjZX$pkgr …r¡}r¢(jAUjBjœubajEj‚ubjZX, r£…r¤}r¥(jAX, r¦jCNjPNjQhjBjlubjz)r§}r¨(jAX ``$version``jG}r©(jI]jJ]jK]jL]jN]ujBjlj<]rªjZX$versionr«…r¬}r­(jAUjBj§ubajEj‚ubjZX, r®…r¯}r°(jAX, jBjlubjz)r±}r²(jAX ``$compiler``jG}r³(jI]jJ]jK]jL]jN]ujBjlj<]r´jZX $compilerrµ…r¶}r·(jAUjBj±ubajEj‚ubjZX, r¸…r¹}rº(jAX, jBjlubjz)r»}r¼(jAX``$os``jG}r½(jI]jJ]jK]jL]jN]ujBjlj<]r¾jZX$osr¿…rÀ}rÁ(jAUjBj»ubajEj‚ubjZX, rÂ…rÃ}rÄ(jAX, jBjlubjz)rÅ}rÆ(jAX ``$arch``jG}rÇ(jI]jJ]jK]jL]jN]ujBjlj<]rÈjZX$archrÉ…rÊ}rË(jAUjBjÅubajEj‚ubjZX, rÌ…rÍ}rÎ(jAj‡jBjlubjz)rÏ}rÐ(jAX``$abi``jG}rÑ(jI]jJ]jK]jL]jN]ujBjlj<]rÒjZX$abirÓ…rÔ}rÕ(jAUjBjÏubajEj‚ubjZX, rÖ…r×}rØ(jAj¦jBjlubjz)rÙ}rÚ(jAX ``$abitag``jG}rÛ(jI]jJ]jK]jL]jN]ujBjlj<]rÜjZX$abitagrÝ…rÞ}rß(jAUjBjÙubajEj‚ubeubeubeubjŠ)rà}rá(jAUjBjí jCjDjEjjG}râ(jL]jK]jI]jJ]jN]Uentries]rã(jX4setup-configure command line option; --dynlibdir=dirhÔUNträaujPNjQhj<]ubj’)rå}ræ(jAUjBjí jCjDjEj•jG}rç(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrèj›jèujPNjQhj<]ré(j)rê}rë(jAX--dynlibdir=dirjBjåjCjDjEj jG}rì(j¢]ríX --dynlibdirrîajL]rïhÔajK]jI]jJ]jN]rðh1aj¨‰ujPMfjQhj<]rñ(jª)rò}ró(jAjîjBjêjCjDjEj­jG}rô(jµj¶jL]jK]jI]jJ]jN]ujPMfjQhj<]rõjZX --dynlibdirrö…r÷}rø(jAUjCNjPNjQhjBjòubaubj³)rù}rú(jAX=dirjBjêjCjDjEj¶jG}rû(jµj¶jL]jK]jI]jJ]jN]ujPMfjQhj<]rüjZX=dirrý…rþ}rÿ(jAUjCNjPNjQhjBjùubaubeubjÎ)r}r(jAUjBjåjCjDjEjÑjG}r(jI]jJ]jK]jL]jN]ujPMfjQhj<]r(jq)r}r(jAX%Dynamic libraries are installed here.rjBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM]jQhj<]rjZX%Dynamic libraries are installed here.r …r }r (jAjjCNjPNjQhjBjubaubjq)r }r (jAX^By default, this is set to `$libdir/$abi`, which is usually not equal to `$libdir/$libsubdir`.jBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM_jQhj<]r(jZXBy default, this is set to r…r}r(jAXBy default, this is set to jCNjPNjQhjBj ubcdocutils.nodes title_reference r)r}r(jAX`$libdir/$abi`jG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZX $libdir/$abir…r}r(jAUjBjubajEUtitle_referencerubjZX , which is usually not equal to r…r}r(jAX , which is usually not equal to jCNjPNjQhjBj ubj)r}r (jAX`$libdir/$libsubdir`jG}r!(jI]jJ]jK]jL]jN]ujBj j<]r"jZX$libdir/$libsubdirr#…r$}r%(jAUjBjubajEjubjZX.…r&}r'(jAX.jCNjPNjQhjBj ubeubjq)r(}r)(jAXÏIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjjCjDjEjtjG}r*(jI]jJ]jK]jL]jN]ujPMbjQhj<]r+(jZXIn the simple build system, r,…r-}r.(jAXIn the simple build system, jCNjPNjQhjBj(ubjµ)r/}r0(jAX*dir*jG}r1(jI]jJ]jK]jL]jN]ujBj(j<]r2jZXdirr3…r4}r5(jAUjBj/ubajEj½ubjZX+ may contain the following path variables: r6…r7}r8(jAX+ may contain the following path variables: jCNjPNjQhjBj(ubjz)r9}r:(jAX ``$prefix``jG}r;(jI]jJ]jK]jL]jN]ujBj(j<]r<jZX$prefixr=…r>}r?(jAUjBj9ubajEj‚ubjZX, r@…rA}rB(jAX, rCjCNjPNjQhjBj(ubjz)rD}rE(jAX ``$bindir``jG}rF(jI]jJ]jK]jL]jN]ujBj(j<]rGjZX$bindirrH…rI}rJ(jAUjBjDubajEj‚ubjZX, rK…rL}rM(jAX, jBj(ubjz)rN}rO(jAX ``$libdir``jG}rP(jI]jJ]jK]jL]jN]ujBj(j<]rQjZX$libdirrR…rS}rT(jAUjBjNubajEj‚ubjZX, rU…rV}rW(jAX, jBj(ubjz)rX}rY(jAX ``$pkgid``jG}rZ(jI]jJ]jK]jL]jN]ujBj(j<]r[jZX$pkgidr\…r]}r^(jAUjBjXubajEj‚ubjZX, r_…r`}ra(jAX, jBj(ubjz)rb}rc(jAX``$pkg``jG}rd(jI]jJ]jK]jL]jN]ujBj(j<]rejZX$pkgrf…rg}rh(jAUjBjbubajEj‚ubjZX, ri…rj}rk(jAX, rljCNjPNjQhjBj(ubjz)rm}rn(jAX ``$version``jG}ro(jI]jJ]jK]jL]jN]ujBj(j<]rpjZX$versionrq…rr}rs(jAUjBjmubajEj‚ubjZX, rt…ru}rv(jAX, jBj(ubjz)rw}rx(jAX ``$compiler``jG}ry(jI]jJ]jK]jL]jN]ujBj(j<]rzjZX $compilerr{…r|}r}(jAUjBjwubajEj‚ubjZX, r~…r}r€(jAX, jBj(ubjz)r}r‚(jAX``$os``jG}rƒ(jI]jJ]jK]jL]jN]ujBj(j<]r„jZX$osr……r†}r‡(jAUjBjubajEj‚ubjZX, rˆ…r‰}rŠ(jAX, jBj(ubjz)r‹}rŒ(jAX ``$arch``jG}r(jI]jJ]jK]jL]jN]ujBj(j<]rŽjZX$archr…r}r‘(jAUjBj‹ubajEj‚ubjZX, r’…r“}r”(jAjCjBj(ubjz)r•}r–(jAX``$abi``jG}r—(jI]jJ]jK]jL]jN]ujBj(j<]r˜jZX$abir™…rš}r›(jAUjBj•ubajEj‚ubjZX, rœ…r}rž(jAjljBj(ubjz)rŸ}r (jAX ``$abitag``jG}r¡(jI]jJ]jK]jL]jN]ujBj(j<]r¢jZX$abitagr£…r¤}r¥(jAUjBjŸubajEj‚ubeubeubeubjŠ)r¦}r§(jAUjBjí jCjDjEjjG}r¨(jL]jK]jI]jJ]jN]Uentries]r©(jX5setup-configure command line option; --libexecdir=dirh±UNtrªaujPNjQhj<]ubj’)r«}r¬(jAUjBjí jCjDjEj•jG}r­(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr®j›j®ujPNjQhj<]r¯(j)r°}r±(jAX--libexecdir=dirjBj«jCjDjEj jG}r²(j¢]r³X --libexecdirr´ajL]rµh±ajK]jI]jJ]jN]r¶haj¨‰ujPMpjQhj<]r·(jª)r¸}r¹(jAj´jBj°jCjDjEj­jG}rº(jµj¶jL]jK]jI]jJ]jN]ujPMpjQhj<]r»jZX --libexecdirr¼…r½}r¾(jAUjCNjPNjQhjBj¸ubaubj³)r¿}rÀ(jAX=dirjBj°jCjDjEj¶jG}rÁ(jµj¶jL]jK]jI]jJ]jN]ujPMpjQhj<]rÂjZX=dirrÃ…rÄ}rÅ(jAUjCNjPNjQhjBj¿ubaubeubjÎ)rÆ}rÇ(jAUjBj«jCjDjEjÑjG}rÈ(jI]jJ]jK]jL]jN]ujPMpjQhj<]rÉ(jq)rÊ}rË(jAXXExecutables that are not expected to be invoked directly by the user are installed here.rÌjBjÆjCjDjEjtjG}rÍ(jI]jJ]jK]jL]jN]ujPMijQhj<]rÎjZXXExecutables that are not expected to be invoked directly by the user are installed here.rÏ…rÐ}rÑ(jAjÌjCNjPNjQhjBjÊubaubjq)rÒ}rÓ(jAXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjÆjCjDjEjtjG}rÔ(jI]jJ]jK]jL]jN]ujPMljQhj<]rÕ(jZXIn the simple build system, rÖ…r×}rØ(jAXIn the simple build system, jCNjPNjQhjBjÒubjµ)rÙ}rÚ(jAX*dir*jG}rÛ(jI]jJ]jK]jL]jN]ujBjÒj<]rÜjZXdirrÝ…rÞ}rß(jAUjBjÙubajEj½ubjZX+ may contain the following path variables: rà…rá}râ(jAX+ may contain the following path variables: jCNjPNjQhjBjÒubjz)rã}rä(jAX ``$prefix``jG}rå(jI]jJ]jK]jL]jN]ujBjÒj<]ræjZX$prefixrç…rè}ré(jAUjBjãubajEj‚ubjZX, rê…rë}rì(jAX, ríjCNjPNjQhjBjÒubjz)rî}rï(jAX ``$bindir``jG}rð(jI]jJ]jK]jL]jN]ujBjÒj<]rñjZX$bindirrò…ró}rô(jAUjBjîubajEj‚ubjZX, rõ…rö}r÷(jAX, jBjÒubjz)rø}rù(jAX ``$libdir``jG}rú(jI]jJ]jK]jL]jN]ujBjÒj<]rûjZX$libdirrü…rý}rþ(jAUjBjøubajEj‚ubjZX, rÿ…r}r(jAX, jBjÒubjz)r}r(jAX``$libsubdir``jG}r(jI]jJ]jK]jL]jN]ujBjÒj<]rjZX $libsubdirr…r}r(jAUjBjubajEj‚ubjZX, r …r }r (jAX, r jCNjPNjQhjBjÒubjz)r }r(jAX ``$pkgid``jG}r(jI]jJ]jK]jL]jN]ujBjÒj<]rjZX$pkgidr…r}r(jAUjBj ubajEj‚ubjZX, r…r}r(jAX, jBjÒubjz)r}r(jAX``$pkg``jG}r(jI]jJ]jK]jL]jN]ujBjÒj<]rjZX$pkgr…r}r(jAUjBjubajEj‚ubjZX, r…r}r (jAX, jBjÒubjz)r!}r"(jAX ``$version``jG}r#(jI]jJ]jK]jL]jN]ujBjÒj<]r$jZX$versionr%…r&}r'(jAUjBj!ubajEj‚ubjZX, r(…r)}r*(jAX, jBjÒubjz)r+}r,(jAX ``$compiler``jG}r-(jI]jJ]jK]jL]jN]ujBjÒj<]r.jZX $compilerr/…r0}r1(jAUjBj+ubajEj‚ubjZX, r2…r3}r4(jAX, jBjÒubjz)r5}r6(jAX``$os``jG}r7(jI]jJ]jK]jL]jN]ujBjÒj<]r8jZX$osr9…r:}r;(jAUjBj5ubajEj‚ubjZX, r<…r=}r>(jAj jBjÒubjz)r?}r@(jAX ``$arch``jG}rA(jI]jJ]jK]jL]jN]ujBjÒj<]rBjZX$archrC…rD}rE(jAUjBj?ubajEj‚ubjZX, rF…rG}rH(jAX, jBjÒubjz)rI}rJ(jAX``$abi``jG}rK(jI]jJ]jK]jL]jN]ujBjÒj<]rLjZX$abirM…rN}rO(jAUjBjIubajEj‚ubjZX, rP…rQ}rR(jAjíjBjÒubjz)rS}rT(jAX ``$abitag``jG}rU(jI]jJ]jK]jL]jN]ujBjÒj<]rVjZX$abitagrW…rX}rY(jAUjBjSubajEj‚ubeubeubeubjŠ)rZ}r[(jAUjBjí jCjDjEjjG}r\(jL]jK]jI]jJ]jN]Uentries]r](jX2setup-configure command line option; --datadir=dirhÖUNtr^aujPNjQhj<]ubj’)r_}r`(jAUjBjí jCjDjEj•jG}ra(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrbj›jbujPNjQhj<]rc(j)rd}re(jAX --datadir=dirjBj_jCjDjEj jG}rf(j¢]rgX --datadirrhajL]rihÖajK]jI]jJ]jN]rjh3aj¨‰ujPMyjQhj<]rk(jª)rl}rm(jAjhjBjdjCjDjEj­jG}rn(jµj¶jL]jK]jI]jJ]jN]ujPMyjQhj<]rojZX --datadirrp…rq}rr(jAUjCNjPNjQhjBjlubaubj³)rs}rt(jAX=dirjBjdjCjDjEj¶jG}ru(jµj¶jL]jK]jI]jJ]jN]ujPMyjQhj<]rvjZX=dirrw…rx}ry(jAUjCNjPNjQhjBjsubaubeubjÎ)rz}r{(jAUjBj_jCjDjEjÑjG}r|(jI]jJ]jK]jL]jN]ujPMyjQhj<]r}(jq)r~}r(jAX7Architecture-independent data files are installed here.r€jBjzjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMsjQhj<]r‚jZX7Architecture-independent data files are installed here.rƒ…r„}r…(jAj€jCNjPNjQhjBj~ubaubjq)r†}r‡(jAXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjzjCjDjEjtjG}rˆ(jI]jJ]jK]jL]jN]ujPMujQhj<]r‰(jZXIn the simple build system, rŠ…r‹}rŒ(jAXIn the simple build system, jCNjPNjQhjBj†ubjµ)r}rŽ(jAX*dir*jG}r(jI]jJ]jK]jL]jN]ujBj†j<]rjZXdirr‘…r’}r“(jAUjBjubajEj½ubjZX+ may contain the following path variables: r”…r•}r–(jAX+ may contain the following path variables: jCNjPNjQhjBj†ubjz)r—}r˜(jAX ``$prefix``jG}r™(jI]jJ]jK]jL]jN]ujBj†j<]ršjZX$prefixr›…rœ}r(jAUjBj—ubajEj‚ubjZX, rž…rŸ}r (jAX, r¡jCNjPNjQhjBj†ubjz)r¢}r£(jAX ``$bindir``jG}r¤(jI]jJ]jK]jL]jN]ujBj†j<]r¥jZX$bindirr¦…r§}r¨(jAUjBj¢ubajEj‚ubjZX, r©…rª}r«(jAX, jBj†ubjz)r¬}r­(jAX ``$libdir``jG}r®(jI]jJ]jK]jL]jN]ujBj†j<]r¯jZX$libdirr°…r±}r²(jAUjBj¬ubajEj‚ubjZX, r³…r´}rµ(jAX, jBj†ubjz)r¶}r·(jAX``$libsubdir``jG}r¸(jI]jJ]jK]jL]jN]ujBj†j<]r¹jZX $libsubdirrº…r»}r¼(jAUjBj¶ubajEj‚ubjZX, r½…r¾}r¿(jAX, rÀjCNjPNjQhjBj†ubjz)rÁ}rÂ(jAX ``$pkgid``jG}rÃ(jI]jJ]jK]jL]jN]ujBj†j<]rÄjZX$pkgidrÅ…rÆ}rÇ(jAUjBjÁubajEj‚ubjZX, rÈ…rÉ}rÊ(jAX, jBj†ubjz)rË}rÌ(jAX``$pkg``jG}rÍ(jI]jJ]jK]jL]jN]ujBj†j<]rÎjZX$pkgrÏ…rÐ}rÑ(jAUjBjËubajEj‚ubjZX, rÒ…rÓ}rÔ(jAX, jBj†ubjz)rÕ}rÖ(jAX ``$version``jG}r×(jI]jJ]jK]jL]jN]ujBj†j<]rØjZX$versionrÙ…rÚ}rÛ(jAUjBjÕubajEj‚ubjZX, rÜ…rÝ}rÞ(jAX, jBj†ubjz)rß}rà(jAX ``$compiler``jG}rá(jI]jJ]jK]jL]jN]ujBj†j<]râjZX $compilerrã…rä}rå(jAUjBjßubajEj‚ubjZX, ræ…rç}rè(jAX, jBj†ubjz)ré}rê(jAX``$os``jG}rë(jI]jJ]jK]jL]jN]ujBj†j<]rìjZX$osrí…rî}rï(jAUjBjéubajEj‚ubjZX, rð…rñ}rò(jAjÀjBj†ubjz)ró}rô(jAX ``$arch``jG}rõ(jI]jJ]jK]jL]jN]ujBj†j<]röjZX$archr÷…rø}rù(jAUjBjóubajEj‚ubjZX, rú…rû}rü(jAX, jBj†ubjz)rý}rþ(jAX``$abi``jG}rÿ(jI]jJ]jK]jL]jN]ujBj†j<]rjZX$abir…r}r(jAUjBjýubajEj‚ubjZX, r…r}r(jAj¡jBj†ubjz)r}r(jAX ``$abitag``jG}r (jI]jJ]jK]jL]jN]ujBj†j<]r jZX$abitagr …r }r (jAUjBjubajEj‚ubeubeubeubjŠ)r}r(jAUjBjí jCjDjEjjG}r(jL]jK]jI]jJ]jN]Uentries]r(jX5setup-configure command line option; --sysconfdir=dirjUNtraujPNjQhj<]ubj’)r}r(jAUjBjí jCjDjEj•jG}r(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrj›jujPNjQhj<]r(j)r}r(jAX--sysconfdir=dirjBjjCjDjEj jG}r(j¢]rX --sysconfdirrajL]rjajK]jI]jJ]jN]rhvaj¨‰ujPM‚jQhj<]r(jª)r }r!(jAjjBjjCjDjEj­jG}r"(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]r#jZX --sysconfdirr$…r%}r&(jAUjCNjPNjQhjBj ubaubj³)r'}r((jAX=dirjBjjCjDjEj¶jG}r)(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]r*jZX=dirr+…r,}r-(jAUjCNjPNjQhjBj'ubaubeubjÎ)r.}r/(jAUjBjjCjDjEjÑjG}r0(jI]jJ]jK]jL]jN]ujPM‚jQhj<]r1(jq)r2}r3(jAX3Installation directory for the configuration files.r4jBj.jCjDjEjtjG}r5(jI]jJ]jK]jL]jN]ujPM|jQhj<]r6jZX3Installation directory for the configuration files.r7…r8}r9(jAj4jCNjPNjQhjBj2ubaubjq)r:}r;(jAXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj.jCjDjEjtjG}r<(jI]jJ]jK]jL]jN]ujPM~jQhj<]r=(jZXIn the simple build system, r>…r?}r@(jAXIn the simple build system, jCNjPNjQhjBj:ubjµ)rA}rB(jAX*dir*jG}rC(jI]jJ]jK]jL]jN]ujBj:j<]rDjZXdirrE…rF}rG(jAUjBjAubajEj½ubjZX+ may contain the following path variables: rH…rI}rJ(jAX+ may contain the following path variables: jCNjPNjQhjBj:ubjz)rK}rL(jAX ``$prefix``jG}rM(jI]jJ]jK]jL]jN]ujBj:j<]rNjZX$prefixrO…rP}rQ(jAUjBjKubajEj‚ubjZX, rR…rS}rT(jAX, rUjCNjPNjQhjBj:ubjz)rV}rW(jAX ``$bindir``jG}rX(jI]jJ]jK]jL]jN]ujBj:j<]rYjZX$bindirrZ…r[}r\(jAUjBjVubajEj‚ubjZX, r]…r^}r_(jAX, jBj:ubjz)r`}ra(jAX ``$libdir``jG}rb(jI]jJ]jK]jL]jN]ujBj:j<]rcjZX$libdirrd…re}rf(jAUjBj`ubajEj‚ubjZX, rg…rh}ri(jAX, jBj:ubjz)rj}rk(jAX``$libsubdir``jG}rl(jI]jJ]jK]jL]jN]ujBj:j<]rmjZX $libsubdirrn…ro}rp(jAUjBjjubajEj‚ubjZX, rq…rr}rs(jAX, rtjCNjPNjQhjBj:ubjz)ru}rv(jAX ``$pkgid``jG}rw(jI]jJ]jK]jL]jN]ujBj:j<]rxjZX$pkgidry…rz}r{(jAUjBjuubajEj‚ubjZX, r|…r}}r~(jAX, jBj:ubjz)r}r€(jAX``$pkg``jG}r(jI]jJ]jK]jL]jN]ujBj:j<]r‚jZX$pkgrƒ…r„}r…(jAUjBjubajEj‚ubjZX, r†…r‡}rˆ(jAX, jBj:ubjz)r‰}rŠ(jAX ``$version``jG}r‹(jI]jJ]jK]jL]jN]ujBj:j<]rŒjZX$versionr…rŽ}r(jAUjBj‰ubajEj‚ubjZX, r…r‘}r’(jAX, jBj:ubjz)r“}r”(jAX ``$compiler``jG}r•(jI]jJ]jK]jL]jN]ujBj:j<]r–jZX $compilerr—…r˜}r™(jAUjBj“ubajEj‚ubjZX, rš…r›}rœ(jAX, jBj:ubjz)r}rž(jAX``$os``jG}rŸ(jI]jJ]jK]jL]jN]ujBj:j<]r jZX$osr¡…r¢}r£(jAUjBjubajEj‚ubjZX, r¤…r¥}r¦(jAjtjBj:ubjz)r§}r¨(jAX ``$arch``jG}r©(jI]jJ]jK]jL]jN]ujBj:j<]rªjZX$archr«…r¬}r­(jAUjBj§ubajEj‚ubjZX, r®…r¯}r°(jAX, jBj:ubjz)r±}r²(jAX``$abi``jG}r³(jI]jJ]jK]jL]jN]ujBj:j<]r´jZX$abirµ…r¶}r·(jAUjBj±ubajEj‚ubjZX, r¸…r¹}rº(jAjUjBj:ubjz)r»}r¼(jAX ``$abitag``jG}r½(jI]jJ]jK]jL]jN]ujBj:j<]r¾jZX$abitagr¿…rÀ}rÁ(jAUjBj»ubajEj‚ubeubeubeubjq)rÂ}rÃ(jAXUIn addition the simple build system supports the following installation path options:rÄjBjí jCjDjEjtjG}rÅ(jI]jJ]jK]jL]jN]ujPMƒjQhj<]rÆjZXUIn addition the simple build system supports the following installation path options:rÇ…rÈ}rÉ(jAjÄjCNjPNjQhjBjÂubaubjŠ)rÊ}rË(jAUjBjí jCjDjEjjG}rÌ(jL]jK]jI]jJ]jN]Uentries]rÍ(jX4setup-configure command line option; --libsubdir=dirjUNtrÎaujPNjQhj<]ubj’)rÏ}rÐ(jAUjBjí jCjDjEj•jG}rÑ(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÒj›jÒujPNjQhj<]rÓ(j)rÔ}rÕ(jAX--libsubdir=dirjBjÏjCjDjEj jG}rÖ(j¢]r×X --libsubdirrØajL]rÙjajK]jI]jJ]jN]rÚhxaj¨‰ujPM“jQhj<]rÛ(jª)rÜ}rÝ(jAjØjBjÔjCjDjEj­jG}rÞ(jµj¶jL]jK]jI]jJ]jN]ujPM“jQhj<]rßjZX --libsubdirrà…rá}râ(jAUjCNjPNjQhjBjÜubaubj³)rã}rä(jAX=dirjBjÔjCjDjEj¶jG}rå(jµj¶jL]jK]jI]jJ]jN]ujPM“jQhj<]ræjZX=dirrç…rè}ré(jAUjCNjPNjQhjBjãubaubeubjÎ)rê}rë(jAUjBjÏjCjDjEjÑjG}rì(jI]jJ]jK]jL]jN]ujPM“jQhj<]rí(jq)rî}rï(jAX˜A subdirectory of *libdir* in which libraries are actually installed. For example, in the simple build system on Unix, the default *libdir* is ``/usr/local/lib``, and *libsubdir* contains the compiler ABI and package identifier, e.g. ``x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A``, so libraries would be installed in ``/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/``.jBjêjCjDjEjtjG}rð(jI]jJ]jK]jL]jN]ujPMˆjQhj<]rñ(jZXA subdirectory of rò…ró}rô(jAXA subdirectory of jCNjPNjQhjBjîubjµ)rõ}rö(jAX*libdir*jG}r÷(jI]jJ]jK]jL]jN]ujBjîj<]røjZXlibdirrù…rú}rû(jAUjBjõubajEj½ubjZXi in which libraries are actually installed. For example, in the simple build system on Unix, the default rü…rý}rþ(jAXi in which libraries are actually installed. For example, in the simple build system on Unix, the default jCNjPNjQhjBjîubjµ)rÿ}r(jAX*libdir*jG}r(jI]jJ]jK]jL]jN]ujBjîj<]rjZXlibdirr…r}r(jAUjBjÿubajEj½ubjZX is r…r}r(jAX is jCNjPNjQhjBjîubjz)r }r (jAX``/usr/local/lib``jG}r (jI]jJ]jK]jL]jN]ujBjîj<]r jZX/usr/local/libr …r}r(jAUjBj ubajEj‚ubjZX, and r…r}r(jAX, and jCNjPNjQhjBjîubjµ)r}r(jAX *libsubdir*jG}r(jI]jJ]jK]jL]jN]ujBjîj<]rjZX libsubdirr…r}r(jAUjBjubajEj½ubjZX8 contains the compiler ABI and package identifier, e.g. r…r}r(jAX8 contains the compiler ABI and package identifier, e.g. jCNjPNjQhjBjîubjz)r}r(jAX<``x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A``jG}r(jI]jJ]jK]jL]jN]ujBjîj<]r jZX8x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7Ar!…r"}r#(jAUjBjubajEj‚ubjZX%, so libraries would be installed in r$…r%}r&(jAX%, so libraries would be installed in jCNjPNjQhjBjîubjz)r'}r((jAXL``/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/``jG}r)(jI]jJ]jK]jL]jN]ujBjîj<]r*jZXH/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/r+…r,}r-(jAUjBj'ubajEj‚ubjZX.…r.}r/(jAX.jCNjPNjQhjBjîubeubjq)r0}r1(jAXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjêjCjDjEjtjG}r2(jI]jJ]jK]jL]jN]ujPMjQhj<]r3(jµ)r4}r5(jAX*dir*jG}r6(jI]jJ]jK]jL]jN]ujBj0j<]r7jZXdirr8…r9}r:(jAUjBj4ubajEj½ubjZX+ may contain the following path variables: r;…r<}r=(jAX+ may contain the following path variables: jCNjPNjQhjBj0ubjz)r>}r?(jAX ``$pkgid``jG}r@(jI]jJ]jK]jL]jN]ujBj0j<]rAjZX$pkgidrB…rC}rD(jAUjBj>ubajEj‚ubjZX, rE…rF}rG(jAX, rHjCNjPNjQhjBj0ubjz)rI}rJ(jAX``$pkg``jG}rK(jI]jJ]jK]jL]jN]ujBj0j<]rLjZX$pkgrM…rN}rO(jAUjBjIubajEj‚ubjZX, rP…rQ}rR(jAX, rSjCNjPNjQhjBj0ubjz)rT}rU(jAX ``$version``jG}rV(jI]jJ]jK]jL]jN]ujBj0j<]rWjZX$versionrX…rY}rZ(jAUjBjTubajEj‚ubjZX, r[…r\}r](jAX, jBj0ubjz)r^}r_(jAX ``$compiler``jG}r`(jI]jJ]jK]jL]jN]ujBj0j<]rajZX $compilerrb…rc}rd(jAUjBj^ubajEj‚ubjZX, re…rf}rg(jAX, jBj0ubjz)rh}ri(jAX``$os``jG}rj(jI]jJ]jK]jL]jN]ujBj0j<]rkjZX$osrl…rm}rn(jAUjBjhubajEj‚ubjZX, ro…rp}rq(jAX, jBj0ubjz)rr}rs(jAX ``$arch``jG}rt(jI]jJ]jK]jL]jN]ujBj0j<]rujZX$archrv…rw}rx(jAUjBjrubajEj‚ubjZX, ry…rz}r{(jAjSjBj0ubjz)r|}r}(jAX``$abi``jG}r~(jI]jJ]jK]jL]jN]ujBj0j<]rjZX$abir€…r}r‚(jAUjBj|ubajEj‚ubjZX, rƒ…r„}r…(jAjHjBj0ubjz)r†}r‡(jAX ``$abitag``jG}rˆ(jI]jJ]jK]jL]jN]ujBj0j<]r‰jZX$abitagrŠ…r‹}rŒ(jAUjBj†ubajEj‚ubeubeubeubjŠ)r}rŽ(jAUjBjí jCjDjEjjG}r(jL]jK]jI]jJ]jN]Uentries]r(jX8setup-configure command line option; --libexecsubdir=dirhÐUNtr‘aujPNjQhj<]ubj’)r’}r“(jAUjBjí jCjDjEj•jG}r”(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr•j›j•ujPNjQhj<]r–(j)r—}r˜(jAX--libexecsubdir=dirjBj’jCjDjEj jG}r™(j¢]ršX--libexecsubdirr›ajL]rœhÐajK]jI]jJ]jN]rh-aj¨‰ujPMŸjQhj<]rž(jª)rŸ}r (jAj›jBj—jCjDjEj­jG}r¡(jµj¶jL]jK]jI]jJ]jN]ujPMŸjQhj<]r¢jZX--libexecsubdirr£…r¤}r¥(jAUjCNjPNjQhjBjŸubaubj³)r¦}r§(jAX=dirjBj—jCjDjEj¶jG}r¨(jµj¶jL]jK]jI]jJ]jN]ujPMŸjQhj<]r©jZX=dirrª…r«}r¬(jAUjCNjPNjQhjBj¦ubaubeubjÎ)r­}r®(jAUjBj’jCjDjEjÑjG}r¯(jI]jJ]jK]jL]jN]ujPMŸjQhj<]r°(jq)r±}r²(jAXRA subdirectory of *libexecdir* in which private executables are installed. For example, in the simple build system on Unix, the default *libexecdir* is ``/usr/local/libexec``, and *libsubdir* is ``x86_64-linux-ghc-8.0.2/mypkg-0.1.0``, so private executables would be installed in ``/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/``jBj­jCjDjEjtjG}r³(jI]jJ]jK]jL]jN]ujPM–jQhj<]r´(jZXA subdirectory of rµ…r¶}r·(jAXA subdirectory of jCNjPNjQhjBj±ubjµ)r¸}r¹(jAX *libexecdir*jG}rº(jI]jJ]jK]jL]jN]ujBj±j<]r»jZX libexecdirr¼…r½}r¾(jAUjBj¸ubajEj½ubjZXj in which private executables are installed. For example, in the simple build system on Unix, the default r¿…rÀ}rÁ(jAXj in which private executables are installed. For example, in the simple build system on Unix, the default jCNjPNjQhjBj±ubjµ)rÂ}rÃ(jAX *libexecdir*jG}rÄ(jI]jJ]jK]jL]jN]ujBj±j<]rÅjZX libexecdirrÆ…rÇ}rÈ(jAUjBjÂubajEj½ubjZX is rÉ…rÊ}rË(jAX is jCNjPNjQhjBj±ubjz)rÌ}rÍ(jAX``/usr/local/libexec``jG}rÎ(jI]jJ]jK]jL]jN]ujBj±j<]rÏjZX/usr/local/libexecrÐ…rÑ}rÒ(jAUjBjÌubajEj‚ubjZX, and rÓ…rÔ}rÕ(jAX, and jCNjPNjQhjBj±ubjµ)rÖ}r×(jAX *libsubdir*jG}rØ(jI]jJ]jK]jL]jN]ujBj±j<]rÙjZX libsubdirrÚ…rÛ}rÜ(jAUjBjÖubajEj½ubjZX is rÝ…rÞ}rß(jAX is jCNjPNjQhjBj±ubjz)rà}rá(jAX&``x86_64-linux-ghc-8.0.2/mypkg-0.1.0``jG}râ(jI]jJ]jK]jL]jN]ujBj±j<]rãjZX"x86_64-linux-ghc-8.0.2/mypkg-0.1.0rä…rå}ræ(jAUjBjàubajEj‚ubjZX/, so private executables would be installed in rç…rè}ré(jAX/, so private executables would be installed in jCNjPNjQhjBj±ubjz)rê}rë(jAX:``/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/``jG}rì(jI]jJ]jK]jL]jN]ujBj±j<]ríjZX6/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/rî…rï}rð(jAUjBjêubajEj‚ubeubjq)rñ}rò(jAXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj­jCjDjEjtjG}ró(jI]jJ]jK]jL]jN]ujPMœjQhj<]rô(jµ)rõ}rö(jAX*dir*jG}r÷(jI]jJ]jK]jL]jN]ujBjñj<]røjZXdirrù…rú}rû(jAUjBjõubajEj½ubjZX+ may contain the following path variables: rü…rý}rþ(jAX+ may contain the following path variables: jCNjPNjQhjBjñubjz)rÿ}r(jAX ``$pkgid``jG}r(jI]jJ]jK]jL]jN]ujBjñj<]rjZX$pkgidr…r}r(jAUjBjÿubajEj‚ubjZX, r…r}r(jAX, r jCNjPNjQhjBjñubjz)r }r (jAX``$pkg``jG}r (jI]jJ]jK]jL]jN]ujBjñj<]r jZX$pkgr…r}r(jAUjBj ubajEj‚ubjZX, r…r}r(jAX, rjCNjPNjQhjBjñubjz)r}r(jAX ``$version``jG}r(jI]jJ]jK]jL]jN]ujBjñj<]rjZX$versionr…r}r(jAUjBjubajEj‚ubjZX, r…r}r(jAX, jBjñubjz)r}r (jAX ``$compiler``jG}r!(jI]jJ]jK]jL]jN]ujBjñj<]r"jZX $compilerr#…r$}r%(jAUjBjubajEj‚ubjZX, r&…r'}r((jAX, jBjñubjz)r)}r*(jAX``$os``jG}r+(jI]jJ]jK]jL]jN]ujBjñj<]r,jZX$osr-…r.}r/(jAUjBj)ubajEj‚ubjZX, r0…r1}r2(jAX, jBjñubjz)r3}r4(jAX ``$arch``jG}r5(jI]jJ]jK]jL]jN]ujBjñj<]r6jZX$archr7…r8}r9(jAUjBj3ubajEj‚ubjZX, r:…r;}r<(jAjjBjñubjz)r=}r>(jAX``$abi``jG}r?(jI]jJ]jK]jL]jN]ujBjñj<]r@jZX$abirA…rB}rC(jAUjBj=ubajEj‚ubjZX, rD…rE}rF(jAj jBjñubjz)rG}rH(jAX ``$abitag``jG}rI(jI]jJ]jK]jL]jN]ujBjñj<]rJjZX$abitagrK…rL}rM(jAUjBjGubajEj‚ubeubeubeubjŠ)rN}rO(jAUjBjí jCjDjEjjG}rP(jL]jK]jI]jJ]jN]Uentries]rQ(jX5setup-configure command line option; --datasubdir=dirjUNtrRaujPNjQhj<]ubj’)rS}rT(jAUjBjí jCjDjEj•jG}rU(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrVj›jVujPNjQhj<]rW(j)rX}rY(jAX--datasubdir=dirjBjSjCjDjEj jG}rZ(j¢]r[X --datasubdirr\ajL]r]jajK]jI]jJ]jN]r^h_aj¨‰ujPM¨jQhj<]r_(jª)r`}ra(jAj\jBjXjCjDjEj­jG}rb(jµj¶jL]jK]jI]jJ]jN]ujPM¨jQhj<]rcjZX --datasubdirrd…re}rf(jAUjCNjPNjQhjBj`ubaubj³)rg}rh(jAX=dirjBjXjCjDjEj¶jG}ri(jµj¶jL]jK]jI]jJ]jN]ujPM¨jQhj<]rjjZX=dirrk…rl}rm(jAUjCNjPNjQhjBjgubaubeubjÎ)rn}ro(jAUjBjSjCjDjEjÑjG}rp(jI]jJ]jK]jL]jN]ujPM¨jQhj<]rq(jq)rr}rs(jAXGA subdirectory of *datadir* in which data files are actually installed.jBjnjCjDjEjtjG}rt(jI]jJ]jK]jL]jN]ujPM¢jQhj<]ru(jZXA subdirectory of rv…rw}rx(jAXA subdirectory of jCNjPNjQhjBjrubjµ)ry}rz(jAX *datadir*jG}r{(jI]jJ]jK]jL]jN]ujBjrj<]r|jZXdatadirr}…r~}r(jAUjBjyubajEj½ubjZX, in which data files are actually installed.r€…r}r‚(jAX, in which data files are actually installed.jCNjPNjQhjBjrubeubjq)rƒ}r„(jAXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjnjCjDjEjtjG}r…(jI]jJ]jK]jL]jN]ujPM¥jQhj<]r†(jµ)r‡}rˆ(jAX*dir*jG}r‰(jI]jJ]jK]jL]jN]ujBjƒj<]rŠjZXdirr‹…rŒ}r(jAUjBj‡ubajEj½ubjZX+ may contain the following path variables: rŽ…r}r(jAX+ may contain the following path variables: jCNjPNjQhjBjƒubjz)r‘}r’(jAX ``$pkgid``jG}r“(jI]jJ]jK]jL]jN]ujBjƒj<]r”jZX$pkgidr•…r–}r—(jAUjBj‘ubajEj‚ubjZX, r˜…r™}rš(jAX, r›jCNjPNjQhjBjƒubjz)rœ}r(jAX``$pkg``jG}rž(jI]jJ]jK]jL]jN]ujBjƒj<]rŸjZX$pkgr …r¡}r¢(jAUjBjœubajEj‚ubjZX, r£…r¤}r¥(jAX, r¦jCNjPNjQhjBjƒubjz)r§}r¨(jAX ``$version``jG}r©(jI]jJ]jK]jL]jN]ujBjƒj<]rªjZX$versionr«…r¬}r­(jAUjBj§ubajEj‚ubjZX, r®…r¯}r°(jAX, jBjƒubjz)r±}r²(jAX ``$compiler``jG}r³(jI]jJ]jK]jL]jN]ujBjƒj<]r´jZX $compilerrµ…r¶}r·(jAUjBj±ubajEj‚ubjZX, r¸…r¹}rº(jAX, jBjƒubjz)r»}r¼(jAX``$os``jG}r½(jI]jJ]jK]jL]jN]ujBjƒj<]r¾jZX$osr¿…rÀ}rÁ(jAUjBj»ubajEj‚ubjZX, rÂ…rÃ}rÄ(jAX, jBjƒubjz)rÅ}rÆ(jAX ``$arch``jG}rÇ(jI]jJ]jK]jL]jN]ujBjƒj<]rÈjZX$archrÉ…rÊ}rË(jAUjBjÅubajEj‚ubjZX, rÌ…rÍ}rÎ(jAj¦jBjƒubjz)rÏ}rÐ(jAX``$abi``jG}rÑ(jI]jJ]jK]jL]jN]ujBjƒj<]rÒjZX$abirÓ…rÔ}rÕ(jAUjBjÏubajEj‚ubjZX, rÖ…r×}rØ(jAj›jBjƒubjz)rÙ}rÚ(jAX ``$abitag``jG}rÛ(jI]jJ]jK]jL]jN]ujBjƒj<]rÜjZX$abitagrÝ…rÞ}rß(jAUjBjÙubajEj‚ubeubeubeubjŠ)rà}rá(jAUjBjí jCjDjEjjG}râ(jL]jK]jI]jJ]jN]Uentries]rã(jX1setup-configure command line option; --docdir=dirj%UNträaujPNjQhj<]ubj’)rå}ræ(jAUjBjí jCjDjEj•jG}rç(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrèj›jèujPNjQhj<]ré(j)rê}rë(jAX --docdir=dirjBjåjCjDjEj jG}rì(j¢]ríX--docdirrîajL]rïj%ajK]jI]jJ]jN]rðhˆaj¨‰ujPM±jQhj<]rñ(jª)rò}ró(jAjîjBjêjCjDjEj­jG}rô(jµj¶jL]jK]jI]jJ]jN]ujPM±jQhj<]rõjZX--docdirrö…r÷}rø(jAUjCNjPNjQhjBjòubaubj³)rù}rú(jAX=dirjBjêjCjDjEj¶jG}rû(jµj¶jL]jK]jI]jJ]jN]ujPM±jQhj<]rüjZX=dirrý…rþ}rÿ(jAUjCNjPNjQhjBjùubaubeubjÎ)r}r(jAUjBjåjCjDjEjÑjG}r(jI]jJ]jK]jL]jN]ujPM±jQhj<]r(jq)r}r(jAX=Documentation files are installed relative to this directory.rjBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM«jQhj<]rjZX=Documentation files are installed relative to this directory.r …r }r (jAjjCNjPNjQhjBjubaubjq)r }r (jAXâ*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM­jQhj<]r(jµ)r}r(jAX*dir*jG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZXdirr…r}r(jAUjBjubajEj½ubjZX+ may contain the following path variables: r…r}r(jAX+ may contain the following path variables: jCNjPNjQhjBj ubjz)r}r(jAX ``$prefix``jG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZX$prefixr…r}r (jAUjBjubajEj‚ubjZX, r!…r"}r#(jAX, r$jCNjPNjQhjBj ubjz)r%}r&(jAX ``$bindir``jG}r'(jI]jJ]jK]jL]jN]ujBj j<]r(jZX$bindirr)…r*}r+(jAUjBj%ubajEj‚ubjZX, r,…r-}r.(jAX, r/jCNjPNjQhjBj ubjz)r0}r1(jAX ``$libdir``jG}r2(jI]jJ]jK]jL]jN]ujBj j<]r3jZX$libdirr4…r5}r6(jAUjBj0ubajEj‚ubjZX, r7…r8}r9(jAX, jBj ubjz)r:}r;(jAX``$libsubdir``jG}r<(jI]jJ]jK]jL]jN]ujBj j<]r=jZX $libsubdirr>…r?}r@(jAUjBj:ubajEj‚ubjZX, rA…rB}rC(jAX, jBj ubjz)rD}rE(jAX ``$datadir``jG}rF(jI]jJ]jK]jL]jN]ujBj j<]rGjZX$datadirrH…rI}rJ(jAUjBjDubajEj‚ubjZX, rK…rL}rM(jAX, jBj ubjz)rN}rO(jAX``$datasubdir``jG}rP(jI]jJ]jK]jL]jN]ujBj j<]rQjZX $datasubdirrR…rS}rT(jAUjBjNubajEj‚ubjZX, rU…rV}rW(jAX, jBj ubjz)rX}rY(jAX ``$pkgid``jG}rZ(jI]jJ]jK]jL]jN]ujBj j<]r[jZX$pkgidr\…r]}r^(jAUjBjXubajEj‚ubjZX, r_…r`}ra(jAX, jBj ubjz)rb}rc(jAX``$pkg``jG}rd(jI]jJ]jK]jL]jN]ujBj j<]rejZX$pkgrf…rg}rh(jAUjBjbubajEj‚ubjZX, ri…rj}rk(jAX, jBj ubjz)rl}rm(jAX ``$version``jG}rn(jI]jJ]jK]jL]jN]ujBj j<]rojZX$versionrp…rq}rr(jAUjBjlubajEj‚ubjZX, rs…rt}ru(jAX, jBj ubjz)rv}rw(jAX ``$compiler``jG}rx(jI]jJ]jK]jL]jN]ujBj j<]ryjZX $compilerrz…r{}r|(jAUjBjvubajEj‚ubjZX, r}…r~}r(jAj$jBj ubjz)r€}r(jAX``$os``jG}r‚(jI]jJ]jK]jL]jN]ujBj j<]rƒjZX$osr„…r…}r†(jAUjBj€ubajEj‚ubjZX, r‡…rˆ}r‰(jAX, jBj ubjz)rŠ}r‹(jAX ``$arch``jG}rŒ(jI]jJ]jK]jL]jN]ujBj j<]rjZX$archrŽ…r}r(jAUjBjŠubajEj‚ubjZX, r‘…r’}r“(jAX, jBj ubjz)r”}r•(jAX``$abi``jG}r–(jI]jJ]jK]jL]jN]ujBj j<]r—jZX$abir˜…r™}rš(jAUjBj”ubajEj‚ubjZX, r›…rœ}r(jAj/jBj ubjz)rž}rŸ(jAX ``$abitag``jG}r (jI]jJ]jK]jL]jN]ujBj j<]r¡jZX$abitagr¢…r£}r¤(jAUjBjžubajEj‚ubeubeubeubjŠ)r¥}r¦(jAUjBjí jCjDjEjjG}r§(jL]jK]jI]jJ]jN]Uentries]r¨(jX2setup-configure command line option; --htmldir=dirhÕUNtr©aujPNjQhj<]ubj’)rª}r«(jAUjBjí jCjDjEj•jG}r¬(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr­j›j­ujPNjQhj<]r®(j)r¯}r°(jAX --htmldir=dirjBjªjCjDjEj jG}r±(j¢]r²X --htmldirr³ajL]r´hÕajK]jI]jJ]jN]rµh2aj¨‰ujPMºjQhj<]r¶(jª)r·}r¸(jAj³jBj¯jCjDjEj­jG}r¹(jµj¶jL]jK]jI]jJ]jN]ujPMºjQhj<]rºjZX --htmldirr»…r¼}r½(jAUjCNjPNjQhjBj·ubaubj³)r¾}r¿(jAX=dirjBj¯jCjDjEj¶jG}rÀ(jµj¶jL]jK]jI]jJ]jN]ujPMºjQhj<]rÁjZX=dirrÂ…rÃ}rÄ(jAUjCNjPNjQhjBj¾ubaubeubjÎ)rÅ}rÆ(jAUjBjªjCjDjEjÑjG}rÇ(jI]jJ]jK]jL]jN]ujPMºjQhj<]rÈ(jq)rÉ}rÊ(jAXBHTML documentation files are installed relative to this directory.rËjBjÅjCjDjEjtjG}rÌ(jI]jJ]jK]jL]jN]ujPM´jQhj<]rÍjZXBHTML documentation files are installed relative to this directory.rÎ…rÏ}rÐ(jAjËjCNjPNjQhjBjÉubaubjq)rÑ}rÒ(jAXï*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$docdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBjÅjCjDjEjtjG}rÓ(jI]jJ]jK]jL]jN]ujPM¶jQhj<]rÔ(jµ)rÕ}rÖ(jAX*dir*jG}r×(jI]jJ]jK]jL]jN]ujBjÑj<]rØjZXdirrÙ…rÚ}rÛ(jAUjBjÕubajEj½ubjZX+ may contain the following path variables: rÜ…rÝ}rÞ(jAX+ may contain the following path variables: jCNjPNjQhjBjÑubjz)rß}rà(jAX ``$prefix``jG}rá(jI]jJ]jK]jL]jN]ujBjÑj<]râjZX$prefixrã…rä}rå(jAUjBjßubajEj‚ubjZX, ræ…rç}rè(jAX, réjCNjPNjQhjBjÑubjz)rê}rë(jAX ``$bindir``jG}rì(jI]jJ]jK]jL]jN]ujBjÑj<]ríjZX$bindirrî…rï}rð(jAUjBjêubajEj‚ubjZX, rñ…rò}ró(jAX, rôjCNjPNjQhjBjÑubjz)rõ}rö(jAX ``$libdir``jG}r÷(jI]jJ]jK]jL]jN]ujBjÑj<]røjZX$libdirrù…rú}rû(jAUjBjõubajEj‚ubjZX, rü…rý}rþ(jAX, jBjÑubjz)rÿ}r(jAX``$libsubdir``jG}r(jI]jJ]jK]jL]jN]ujBjÑj<]rjZX $libsubdirr…r}r(jAUjBjÿubajEj‚ubjZX, r…r}r(jAX, jBjÑubjz)r }r (jAX ``$datadir``jG}r (jI]jJ]jK]jL]jN]ujBjÑj<]r jZX$datadirr …r}r(jAUjBj ubajEj‚ubjZX, r…r}r(jAX, jBjÑubjz)r}r(jAX``$datasubdir``jG}r(jI]jJ]jK]jL]jN]ujBjÑj<]rjZX $datasubdirr…r}r(jAUjBjubajEj‚ubjZX, r…r}r(jAX, jBjÑubjz)r}r(jAX ``$docdir``jG}r(jI]jJ]jK]jL]jN]ujBjÑj<]r jZX$docdirr!…r"}r#(jAUjBjubajEj‚ubjZX, r$…r%}r&(jAX, jBjÑubjz)r'}r((jAX ``$pkgid``jG}r)(jI]jJ]jK]jL]jN]ujBjÑj<]r*jZX$pkgidr+…r,}r-(jAUjBj'ubajEj‚ubjZX, r.…r/}r0(jAX, jBjÑubjz)r1}r2(jAX``$pkg``jG}r3(jI]jJ]jK]jL]jN]ujBjÑj<]r4jZX$pkgr5…r6}r7(jAUjBj1ubajEj‚ubjZX, r8…r9}r:(jAX, jBjÑubjz)r;}r<(jAX ``$version``jG}r=(jI]jJ]jK]jL]jN]ujBjÑj<]r>jZX$versionr?…r@}rA(jAUjBj;ubajEj‚ubjZX, rB…rC}rD(jAjéjBjÑubjz)rE}rF(jAX ``$compiler``jG}rG(jI]jJ]jK]jL]jN]ujBjÑj<]rHjZX $compilerrI…rJ}rK(jAUjBjEubajEj‚ubjZX, rL…rM}rN(jAX, jBjÑubjz)rO}rP(jAX``$os``jG}rQ(jI]jJ]jK]jL]jN]ujBjÑj<]rRjZX$osrS…rT}rU(jAUjBjOubajEj‚ubjZX, rV…rW}rX(jAX, jBjÑubjz)rY}rZ(jAX ``$arch``jG}r[(jI]jJ]jK]jL]jN]ujBjÑj<]r\jZX$archr]…r^}r_(jAUjBjYubajEj‚ubjZX, r`…ra}rb(jAX, jBjÑubjz)rc}rd(jAX``$abi``jG}re(jI]jJ]jK]jL]jN]ujBjÑj<]rfjZX$abirg…rh}ri(jAUjBjcubajEj‚ubjZX, rj…rk}rl(jAjôjBjÑubjz)rm}rn(jAX ``$abitag``jG}ro(jI]jJ]jK]jL]jN]ujBjÑj<]rpjZX$abitagrq…rr}rs(jAUjBjmubajEj‚ubeubeubeubjŠ)rt}ru(jAUjBjí jCjDjEjjG}rv(jL]jK]jI]jJ]jN]Uentries]rw(jX<setup-configure command line option; --program-prefix=prefixh×UNtrxaujPNjQhj<]ubj’)ry}rz(jAUjBjí jCjDjEj•jG}r{(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr|j›j|ujPNjQhj<]r}(j)r~}r(jAX--program-prefix=prefixjBjyjCjDjEj jG}r€(j¢]rX--program-prefixr‚ajL]rƒh×ajK]jI]jJ]jN]r„h4aj¨‰ujPMÂjQhj<]r…(jª)r†}r‡(jAj‚jBj~jCjDjEj­jG}rˆ(jµj¶jL]jK]jI]jJ]jN]ujPMÂjQhj<]r‰jZX--program-prefixrŠ…r‹}rŒ(jAUjCNjPNjQhjBj†ubaubj³)r}rŽ(jAX=prefixjBj~jCjDjEj¶jG}r(jµj¶jL]jK]jI]jJ]jN]ujPMÂjQhj<]rjZX=prefixr‘…r’}r“(jAUjCNjPNjQhjBjubaubeubjÎ)r”}r•(jAUjBjyjCjDjEjÑjG}r–(jI]jJ]jK]jL]jN]ujPMÂjQhj<]r—(jq)r˜}r™(jAX,Prepend *prefix* to installed program names.jBj”jCjDjEjtjG}rš(jI]jJ]jK]jL]jN]ujPM½jQhj<]r›(jZXPrepend rœ…r}rž(jAXPrepend jCNjPNjQhjBj˜ubjµ)rŸ}r (jAX*prefix*jG}r¡(jI]jJ]jK]jL]jN]ujBj˜j<]r¢jZXprefixr£…r¤}r¥(jAUjBjŸubajEj½ubjZX to installed program names.r¦…r§}r¨(jAX to installed program names.jCNjPNjQhjBj˜ubeubjq)r©}rª(jAX*prefix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj”jCjDjEjtjG}r«(jI]jJ]jK]jL]jN]ujPM¿jQhj<]r¬(jµ)r­}r®(jAX*prefix*jG}r¯(jI]jJ]jK]jL]jN]ujBj©j<]r°jZXprefixr±…r²}r³(jAUjBj­ubajEj½ubjZX+ may contain the following path variables: r´…rµ}r¶(jAX+ may contain the following path variables: jCNjPNjQhjBj©ubjz)r·}r¸(jAX ``$pkgid``jG}r¹(jI]jJ]jK]jL]jN]ujBj©j<]rºjZX$pkgidr»…r¼}r½(jAUjBj·ubajEj‚ubjZX, r¾…r¿}rÀ(jAX, rÁjCNjPNjQhjBj©ubjz)rÂ}rÃ(jAX``$pkg``jG}rÄ(jI]jJ]jK]jL]jN]ujBj©j<]rÅjZX$pkgrÆ…rÇ}rÈ(jAUjBjÂubajEj‚ubjZX, rÉ…rÊ}rË(jAX, rÌjCNjPNjQhjBj©ubjz)rÍ}rÎ(jAX ``$version``jG}rÏ(jI]jJ]jK]jL]jN]ujBj©j<]rÐjZX$versionrÑ…rÒ}rÓ(jAUjBjÍubajEj‚ubjZX, rÔ…rÕ}rÖ(jAX, jBj©ubjz)r×}rØ(jAX ``$compiler``jG}rÙ(jI]jJ]jK]jL]jN]ujBj©j<]rÚjZX $compilerrÛ…rÜ}rÝ(jAUjBj×ubajEj‚ubjZX, rÞ…rß}rà(jAX, jBj©ubjz)rá}râ(jAX``$os``jG}rã(jI]jJ]jK]jL]jN]ujBj©j<]räjZX$osrå…ræ}rç(jAUjBjáubajEj‚ubjZX, rè…ré}rê(jAX, jBj©ubjz)rë}rì(jAX ``$arch``jG}rí(jI]jJ]jK]jL]jN]ujBj©j<]rîjZX$archrï…rð}rñ(jAUjBjëubajEj‚ubjZX, rò…ró}rô(jAjÌjBj©ubjz)rõ}rö(jAX``$abi``jG}r÷(jI]jJ]jK]jL]jN]ujBj©j<]røjZX$abirù…rú}rû(jAUjBjõubajEj‚ubjZX, rü…rý}rþ(jAjÁjBj©ubjz)rÿ}r(jAX ``$abitag``jG}r(jI]jJ]jK]jL]jN]ujBj©j<]rjZX$abitagr…r}r(jAUjBjÿubajEj‚ubeubeubeubjŠ)r}r(jAUjBjí jCjDjEjjG}r(jL]jK]jI]jJ]jN]Uentries]r (jX<setup-configure command line option; --program-suffix=suffixj&UNtr aujPNjQhj<]ubj’)r }r (jAUjBjí jCjDjEj•jG}r (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrj›jujPNjQhj<]r(j)r}r(jAX--program-suffix=suffixjBj jCjDjEj jG}r(j¢]rX--program-suffixrajL]rj&ajK]jI]jJ]jN]rh‰aj¨‰ujPMÍjQhj<]r(jª)r}r(jAjjBjjCjDjEj­jG}r(jµj¶jL]jK]jI]jJ]jN]ujPMÍjQhj<]rjZX--program-suffixr…r}r(jAUjCNjPNjQhjBjubaubj³)r}r (jAX=suffixjBjjCjDjEj¶jG}r!(jµj¶jL]jK]jI]jJ]jN]ujPMÍjQhj<]r"jZX=suffixr#…r$}r%(jAUjCNjPNjQhjBjubaubeubjÎ)r&}r'(jAUjBj jCjDjEjÑjG}r((jI]jJ]jK]jL]jN]ujPMÍjQhj<]r)(jq)r*}r+(jAXÚAppend *suffix* to installed program names. 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'``.jBj&jCjDjEjtjG}r,(jI]jJ]jK]jL]jN]ujPMÅjQhj<]r-(jZXAppend r.…r/}r0(jAXAppend jCNjPNjQhjBj*ubjµ)r1}r2(jAX*suffix*jG}r3(jI]jJ]jK]jL]jN]ujBj*j<]r4jZXsuffixr5…r6}r7(jAUjBj1ubajEj½ubjZX­ to installed program names. 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: r8…r9}r:(jAX« to installed program names. 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: jCNjPNjQhjBj*ubjz)r;}r<(jAX``--program-suffix='$version'``jG}r=(jI]jJ]jK]jL]jN]ujBj*j<]r>jZX--program-suffix='$version'r?…r@}rA(jAUjBj;ubajEj‚ubjZX.…rB}rC(jAX.jCNjPNjQhjBj*ubeubjq)rD}rE(jAX*suffix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jBj&jCjDjEjtjG}rF(jI]jJ]jK]jL]jN]ujPMÊjQhj<]rG(jµ)rH}rI(jAX*suffix*jG}rJ(jI]jJ]jK]jL]jN]ujBjDj<]rKjZXsuffixrL…rM}rN(jAUjBjHubajEj½ubjZX+ may contain the following path variables: rO…rP}rQ(jAX+ may contain the following path variables: jCNjPNjQhjBjDubjz)rR}rS(jAX ``$pkgid``jG}rT(jI]jJ]jK]jL]jN]ujBjDj<]rUjZX$pkgidrV…rW}rX(jAUjBjRubajEj‚ubjZX, rY…rZ}r[(jAX, r\jCNjPNjQhjBjDubjz)r]}r^(jAX``$pkg``jG}r_(jI]jJ]jK]jL]jN]ujBjDj<]r`jZX$pkgra…rb}rc(jAUjBj]ubajEj‚ubjZX, rd…re}rf(jAX, rgjCNjPNjQhjBjDubjz)rh}ri(jAX ``$version``jG}rj(jI]jJ]jK]jL]jN]ujBjDj<]rkjZX$versionrl…rm}rn(jAUjBjhubajEj‚ubjZX, ro…rp}rq(jAX, jBjDubjz)rr}rs(jAX ``$compiler``jG}rt(jI]jJ]jK]jL]jN]ujBjDj<]rujZX $compilerrv…rw}rx(jAUjBjrubajEj‚ubjZX, ry…rz}r{(jAX, jBjDubjz)r|}r}(jAX``$os``jG}r~(jI]jJ]jK]jL]jN]ujBjDj<]rjZX$osr€…r}r‚(jAUjBj|ubajEj‚ubjZX, rƒ…r„}r…(jAX, jBjDubjz)r†}r‡(jAX ``$arch``jG}rˆ(jI]jJ]jK]jL]jN]ujBjDj<]r‰jZX$archrŠ…r‹}rŒ(jAUjBj†ubajEj‚ubjZX, r…rŽ}r(jAjgjBjDubjz)r}r‘(jAX``$abi``jG}r’(jI]jJ]jK]jL]jN]ujBjDj<]r“jZX$abir”…r•}r–(jAUjBjubajEj‚ubjZX, r—…r˜}r™(jAj\jBjDubjz)rš}r›(jAX ``$abitag``jG}rœ(jI]jJ]jK]jL]jN]ujBjDj<]rjZX$abitagrž…rŸ}r (jAUjBjšubajEj‚ubeubeubeubj>)r¡}r¢(jAUjBjí jCjDjEjFjG}r£(jI]jJ]jK]jL]r¤hØajN]r¥h5aujPMÏjQhj<]r¦(jS)r§}r¨(jAX)Path variables in the simple build systemr©jBj¡jCjDjEjWjG}rª(jI]jJ]jK]jL]jN]ujPMÏjQhj<]r«jZX)Path variables in the simple build systemr¬…r­}r®(jAj©jCNjPNjQhjBj§ubaubjq)r¯}r°(jAX»For the simple build system, there are a number of variables that can be used when specifying installation paths. The defaults are also specified in terms of these variables. A number of the variables are actually for other paths, like ``$prefix``. This allows paths to be specified relative to each other rather than as absolute paths, which is important for building relocatable packages (see `prefix independence <#prefix-independence>`__).jBj¡jCjDjEjtjG}r±(jI]jJ]jK]jL]jN]ujPMÑjQhj<]r²(jZXìFor the simple build system, there are a number of variables that can be used when specifying installation paths. The defaults are also specified in terms of these variables. A number of the variables are actually for other paths, like r³…r´}rµ(jAXìFor the simple build system, there are a number of variables that can be used when specifying installation paths. The defaults are also specified in terms of these variables. A number of the variables are actually for other paths, like jCNjPNjQhjBj¯ubjz)r¶}r·(jAX ``$prefix``jG}r¸(jI]jJ]jK]jL]jN]ujBj¯j<]r¹jZX$prefixrº…r»}r¼(jAUjBj¶ubajEj‚ubjZX”. This allows paths to be specified relative to each other rather than as absolute paths, which is important for building relocatable packages (see r½…r¾}r¿(jAX”. This allows paths to be specified relative to each other rather than as absolute paths, which is important for building relocatable packages (see jCNjPNjQhjBj¯ubj”)rÀ}rÁ(jAX.`prefix independence <#prefix-independence>`__jG}rÂ(UnameXprefix independencejâX#prefix-independencejL]jK]jI]jJ]jN]ujBj¯j<]rÃjZXprefix independencerÄ…rÅ}rÆ(jAUjBjÀubajEjubjZX).rÇ…rÈ}rÉ(jAX).jCNjPNjQhjBj¯ubeubcdocutils.nodes definition_list rÊ)rË}rÌ(jAUjBj¡jCjDjEUdefinition_listrÍjG}rÎ(jI]jJ]jK]jL]jN]ujPNjQhj<]rÏ(cdocutils.nodes definition_list_item rÐ)rÑ}rÒ(jAX¹$prefix The path variable that stands for the root of the installation. For an installation to be relocatable, all other installation paths must be relative to the ``$prefix`` variable.jBjËjCjDjEUdefinition_list_itemrÓjG}rÔ(jI]jJ]jK]jL]jN]ujPMÛj<]rÕ(cdocutils.nodes term rÖ)r×}rØ(jAX$prefixrÙjBjÑjCjDjEUtermrÚjG}rÛ(jI]jJ]jK]jL]jN]ujPMÛj<]rÜjZX$prefixrÝ…rÞ}rß(jAjÙjBj×ubaubcdocutils.nodes definition rà)rá}râ(jAUjG}rã(jI]jJ]jK]jL]jN]ujBjÑj<]räjq)rå}ræ(jAX±The path variable that stands for the root of the installation. For an installation to be relocatable, all other installation paths must be relative to the ``$prefix`` variable.jBjájCjDjEjtjG}rç(jI]jJ]jK]jL]jN]ujPMÚj<]rè(jZXœThe path variable that stands for the root of the installation. For an installation to be relocatable, all other installation paths must be relative to the ré…rê}rë(jAXœThe path variable that stands for the root of the installation. For an installation to be relocatable, all other installation paths must be relative to the jBjåubjz)rì}rí(jAX ``$prefix``jG}rî(jI]jJ]jK]jL]jN]ujBjåj<]rïjZX$prefixrð…rñ}rò(jAUjBjìubajEj‚ubjZX variable.ró…rô}rõ(jAX variable.jBjåubeubajEU definitionröubeubjÐ)r÷}rø(jAXu$bindir The path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jBjËjCjDjEjÓjG}rù(jI]jJ]jK]jL]jN]ujPMÞjQhj<]rú(jÖ)rû}rü(jAX$bindirrýjBj÷jCjDjEjÚjG}rþ(jI]jJ]jK]jL]jN]ujPMÞj<]rÿjZX$bindirr…r}r(jAjýjBjûubaubjà)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBj÷j<]rjq)r}r(jAXmThe path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jBjjCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPMÞj<]r (jZX8The path variable that expands to the path given by the r …r }r (jAX8The path variable that expands to the path given by the jBjubj¥)r}r(jAX:option:`--bindir`rjBjjCjDjEj©jG}r(UreftypeXoptionj«ˆj¬X--bindirU refdomainXstdrjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÞj<]rjz)r}r(jAjjG}r(jI]jJ]r(j¶jX std-optionrejK]jL]jN]ujBjj<]rjZX--bindirr…r}r(jAUjBjubajEj‚ubaubjZX# configure option (or the default).r…r}r(jAX# configure option (or the default).jBjubeubajEjöubeubjÐ)r }r!(jAX+$libdir As above but for :option:`--libdir`jBjËjCjDjEjÓjG}r"(jI]jJ]jK]jL]jN]ujPMàjQhj<]r#(jÖ)r$}r%(jAX$libdirr&jBj jCjDjEjÚjG}r'(jI]jJ]jK]jL]jN]ujPMàj<]r(jZX$libdirr)…r*}r+(jAj&jBj$ubaubjà)r,}r-(jAUjG}r.(jI]jJ]jK]jL]jN]ujBj j<]r/jq)r0}r1(jAX#As above but for :option:`--libdir`jBj,jCjDjEjtjG}r2(jI]jJ]jK]jL]jN]ujPMáj<]r3(jZXAs above but for r4…r5}r6(jAXAs above but for jBj0ubj¥)r7}r8(jAX:option:`--libdir`r9jBj0jCjDjEj©jG}r:(UreftypeXoptionj«ˆj¬X--libdirU refdomainXstdr;jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMáj<]r<jz)r=}r>(jAj9jG}r?(jI]jJ]r@(j¶j;X std-optionrAejK]jL]jN]ujBj7j<]rBjZX--libdirrC…rD}rE(jAUjBj=ubajEj‚ubaubeubajEjöubeubjÐ)rF}rG(jAX1$libsubdir As above but for :option:`--libsubdir`jBjËjCjDjEjÓjG}rH(jI]jJ]jK]jL]jN]ujPMâjQhj<]rI(jÖ)rJ}rK(jAX $libsubdirrLjBjFjCjDjEjÚjG}rM(jI]jJ]jK]jL]jN]ujPMâj<]rNjZX $libsubdirrO…rP}rQ(jAjLjBjJubaubjà)rR}rS(jAUjG}rT(jI]jJ]jK]jL]jN]ujBjFj<]rUjq)rV}rW(jAX&As above but for :option:`--libsubdir`jBjRjCjDjEjtjG}rX(jI]jJ]jK]jL]jN]ujPMãj<]rY(jZXAs above but for rZ…r[}r\(jAXAs above but for jBjVubj¥)r]}r^(jAX:option:`--libsubdir`r_jBjVjCjDjEj©jG}r`(UreftypeXoptionj«ˆj¬X --libsubdirU refdomainXstdrajL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMãj<]rbjz)rc}rd(jAj_jG}re(jI]jJ]rf(j¶jaX std-optionrgejK]jL]jN]ujBj]j<]rhjZX --libsubdirri…rj}rk(jAUjBjcubajEj‚ubaubeubajEjöubeubjÐ)rl}rm(jAX1$dynlibdir As above but for :option:`--dynlibdir`jBjËjCjDjEjÓjG}rn(jI]jJ]jK]jL]jN]ujPMäjQhj<]ro(jÖ)rp}rq(jAX $dynlibdirrrjBjljCjDjEjÚjG}rs(jI]jJ]jK]jL]jN]ujPMäj<]rtjZX $dynlibdirru…rv}rw(jAjrjBjpubaubjà)rx}ry(jAUjG}rz(jI]jJ]jK]jL]jN]ujBjlj<]r{jq)r|}r}(jAX&As above but for :option:`--dynlibdir`jBjxjCjDjEjtjG}r~(jI]jJ]jK]jL]jN]ujPMåj<]r(jZXAs above but for r€…r}r‚(jAXAs above but for jBj|ubj¥)rƒ}r„(jAX:option:`--dynlibdir`r…jBj|jCjDjEj©jG}r†(UreftypeXoptionj«ˆj¬X --dynlibdirU refdomainXstdr‡jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMåj<]rˆjz)r‰}rŠ(jAj…jG}r‹(jI]jJ]rŒ(j¶j‡X std-optionrejK]jL]jN]ujBjƒj<]rŽjZX --dynlibdirr…r}r‘(jAUjBj‰ubajEj‚ubaubeubajEjöubeubjÐ)r’}r“(jAX-$datadir As above but for :option:`--datadir`jBjËjCjDjEjÓjG}r”(jI]jJ]jK]jL]jN]ujPMæjQhj<]r•(jÖ)r–}r—(jAX$datadirr˜jBj’jCjDjEjÚjG}r™(jI]jJ]jK]jL]jN]ujPMæj<]ršjZX$datadirr›…rœ}r(jAj˜jBj–ubaubjà)rž}rŸ(jAUjG}r (jI]jJ]jK]jL]jN]ujBj’j<]r¡jq)r¢}r£(jAX$As above but for :option:`--datadir`jBjžjCjDjEjtjG}r¤(jI]jJ]jK]jL]jN]ujPMçj<]r¥(jZXAs above but for r¦…r§}r¨(jAXAs above but for jBj¢ubj¥)r©}rª(jAX:option:`--datadir`r«jBj¢jCjDjEj©jG}r¬(UreftypeXoptionj«ˆj¬X --datadirU refdomainXstdr­jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMçj<]r®jz)r¯}r°(jAj«jG}r±(jI]jJ]r²(j¶j­X std-optionr³ejK]jL]jN]ujBj©j<]r´jZX --datadirrµ…r¶}r·(jAUjBj¯ubajEj‚ubaubeubajEjöubeubjÐ)r¸}r¹(jAX3$datasubdir As above but for :option:`--datasubdir`jBjËjCjDjEjÓjG}rº(jI]jJ]jK]jL]jN]ujPMèjQhj<]r»(jÖ)r¼}r½(jAX $datasubdirr¾jBj¸jCjDjEjÚjG}r¿(jI]jJ]jK]jL]jN]ujPMèj<]rÀjZX $datasubdirrÁ…rÂ}rÃ(jAj¾jBj¼ubaubjà)rÄ}rÅ(jAUjG}rÆ(jI]jJ]jK]jL]jN]ujBj¸j<]rÇjq)rÈ}rÉ(jAX'As above but for :option:`--datasubdir`jBjÄjCjDjEjtjG}rÊ(jI]jJ]jK]jL]jN]ujPMéj<]rË(jZXAs above but for rÌ…rÍ}rÎ(jAXAs above but for jBjÈubj¥)rÏ}rÐ(jAX:option:`--datasubdir`rÑjBjÈjCjDjEj©jG}rÒ(UreftypeXoptionj«ˆj¬X --datasubdirU refdomainXstdrÓjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMéj<]rÔjz)rÕ}rÖ(jAjÑjG}r×(jI]jJ]rØ(j¶jÓX std-optionrÙejK]jL]jN]ujBjÏj<]rÚjZX --datasubdirrÛ…rÜ}rÝ(jAUjBjÕubajEj‚ubaubeubajEjöubeubjÐ)rÞ}rß(jAX+$docdir As above but for :option:`--docdir`jBjËjCjDjEjÓjG}rà(jI]jJ]jK]jL]jN]ujPMêjQhj<]rá(jÖ)râ}rã(jAX$docdirräjBjÞjCjDjEjÚjG}rå(jI]jJ]jK]jL]jN]ujPMêj<]ræjZX$docdirrç…rè}ré(jAjäjBjâubaubjà)rê}rë(jAUjG}rì(jI]jJ]jK]jL]jN]ujBjÞj<]ríjq)rî}rï(jAX#As above but for :option:`--docdir`jBjêjCjDjEjtjG}rð(jI]jJ]jK]jL]jN]ujPMëj<]rñ(jZXAs above but for rò…ró}rô(jAXAs above but for jBjîubj¥)rõ}rö(jAX:option:`--docdir`r÷jBjîjCjDjEj©jG}rø(UreftypeXoptionj«ˆj¬X--docdirU refdomainXstdrùjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMëj<]rújz)rû}rü(jAj÷jG}rý(jI]jJ]rþ(j¶jùX std-optionrÿejK]jL]jN]ujBjõj<]rjZX--docdirr…r}r(jAUjBjûubajEj‚ubaubeubajEjöubeubjÐ)r}r(jAX>$pkgid The name and version of the package, e.g. ``mypkg-0.2``jBjËjCjDjEjÓjG}r(jI]jJ]jK]jL]jN]ujPMìjQhj<]r(jÖ)r}r (jAX$pkgidr jBjjCjDjEjÚjG}r (jI]jJ]jK]jL]jN]ujPMìj<]r jZX$pkgidr …r}r(jAj jBjubaubjà)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBjj<]rjq)r}r(jAX7The name and version of the package, e.g. ``mypkg-0.2``jBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMíj<]r(jZX*The name and version of the package, e.g. r…r}r(jAX*The name and version of the package, e.g. jBjubjz)r}r(jAX ``mypkg-0.2``jG}r(jI]jJ]jK]jL]jN]ujBjj<]rjZX mypkg-0.2r…r }r!(jAUjBjubajEj‚ubeubajEjöubeubjÐ)r"}r#(jAX,$pkg The name of the package, e.g. ``mypkg``jBjËjCjDjEjÓjG}r$(jI]jJ]jK]jL]jN]ujPMîjQhj<]r%(jÖ)r&}r'(jAX$pkgr(jBj"jCjDjEjÚjG}r)(jI]jJ]jK]jL]jN]ujPMîj<]r*jZX$pkgr+…r,}r-(jAj(jBj&ubaubjà)r.}r/(jAUjG}r0(jI]jJ]jK]jL]jN]ujBj"j<]r1jq)r2}r3(jAX'The name of the package, e.g. ``mypkg``jBj.jCjDjEjtjG}r4(jI]jJ]jK]jL]jN]ujPMïj<]r5(jZXThe name of the package, e.g. r6…r7}r8(jAXThe name of the package, e.g. jBj2ubjz)r9}r:(jAX ``mypkg``jG}r;(jI]jJ]jK]jL]jN]ujBj2j<]r<jZXmypkgr=…r>}r?(jAUjBj9ubajEj‚ubeubajEjöubeubjÐ)r@}rA(jAX1$version The version of the package, e.g. ``0.2``jBjËjCjDjEjÓjG}rB(jI]jJ]jK]jL]jN]ujPMðjQhj<]rC(jÖ)rD}rE(jAX$versionrFjBj@jCjDjEjÚjG}rG(jI]jJ]jK]jL]jN]ujPMðj<]rHjZX$versionrI…rJ}rK(jAjFjBjDubaubjà)rL}rM(jAUjG}rN(jI]jJ]jK]jL]jN]ujBj@j<]rOjq)rP}rQ(jAX(The version of the package, e.g. ``0.2``jBjLjCjDjEjtjG}rR(jI]jJ]jK]jL]jN]ujPMñj<]rS(jZX!The version of the package, e.g. rT…rU}rV(jAX!The version of the package, e.g. jBjPubjz)rW}rX(jAX``0.2``jG}rY(jI]jJ]jK]jL]jN]ujBjPj<]rZjZX0.2r[…r\}r](jAUjBjWubajEj‚ubeubajEjöubeubjÐ)r^}r_(jAXJ$compiler The compiler being used to build the package, e.g. ``ghc-6.6.1``jBjËjCjDjEjÓjG}r`(jI]jJ]jK]jL]jN]ujPMòjQhj<]ra(jÖ)rb}rc(jAX $compilerrdjBj^jCjDjEjÚjG}re(jI]jJ]jK]jL]jN]ujPMòj<]rfjZX $compilerrg…rh}ri(jAjdjBjbubaubjà)rj}rk(jAUjG}rl(jI]jJ]jK]jL]jN]ujBj^j<]rmjq)rn}ro(jAX@The compiler being used to build the package, e.g. ``ghc-6.6.1``jBjjjCjDjEjtjG}rp(jI]jJ]jK]jL]jN]ujPMój<]rq(jZX3The compiler being used to build the package, e.g. rr…rs}rt(jAX3The compiler being used to build the package, e.g. jBjnubjz)ru}rv(jAX ``ghc-6.6.1``jG}rw(jI]jJ]jK]jL]jN]ujBjnj<]rxjZX ghc-6.6.1ry…rz}r{(jAUjBjuubajEj‚ubeubajEjöubeubjÐ)r|}r}(jAXŠ$os The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jBjËjCjDjEjÓjG}r~(jI]jJ]jK]jL]jN]ujPMöjQhj<]r(jÖ)r€}r(jAX$osr‚jBj|jCjDjEjÚjG}rƒ(jI]jJ]jK]jL]jN]ujPMöj<]r„jZX$osr……r†}r‡(jAj‚jBj€ubaubjà)rˆ}r‰(jAUjG}rŠ(jI]jJ]jK]jL]jN]ujBj|j<]r‹jq)rŒ}r(jAX†The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jBjˆjCjDjEjtjG}rŽ(jI]jJ]jK]jL]jN]ujPMõj<]r(jZXKThe operating system of the computer being used to build the package, e.g. r…r‘}r’(jAXKThe operating system of the computer being used to build the package, e.g. jBjŒubjz)r“}r”(jAX ``linux``jG}r•(jI]jJ]jK]jL]jN]ujBjŒj<]r–jZXlinuxr—…r˜}r™(jAUjBj“ubajEj‚ubjZX, rš…r›}rœ(jAX, rjBjŒubjz)rž}rŸ(jAX ``windows``jG}r (jI]jJ]jK]jL]jN]ujBjŒj<]r¡jZXwindowsr¢…r£}r¤(jAUjBjžubajEj‚ubjZX, r¥…r¦}r§(jAX, jBjŒubjz)r¨}r©(jAX``osx``jG}rª(jI]jJ]jK]jL]jN]ujBjŒj<]r«jZXosxr¬…r­}r®(jAUjBj¨ubajEj‚ubjZX, r¯…r°}r±(jAjjBjŒubjz)r²}r³(jAX ``freebsd``jG}r´(jI]jJ]jK]jL]jN]ujBjŒj<]rµjZXfreebsdr¶…r·}r¸(jAUjBj²ubajEj‚ubjZX or r¹…rº}r»(jAX or jBjŒubjz)r¼}r½(jAX ``solaris``jG}r¾(jI]jJ]jK]jL]jN]ujBjŒj<]r¿jZXsolarisrÀ…rÁ}rÂ(jAUjBj¼ubajEj‚ubeubajEjöubeubjÐ)rÃ}rÄ(jAXw$arch The architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jBjËjCjDjEjÓjG}rÅ(jI]jJ]jK]jL]jN]ujPMùjQhj<]rÆ(jÖ)rÇ}rÈ(jAX$archrÉjBjÃjCjDjEjÚjG}rÊ(jI]jJ]jK]jL]jN]ujPMùj<]rËjZX$archrÌ…rÍ}rÎ(jAjÉjBjÇubaubjà)rÏ}rÐ(jAUjG}rÑ(jI]jJ]jK]jL]jN]ujBjÃj<]rÒjq)rÓ}rÔ(jAXqThe architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jBjÏjCjDjEjtjG}rÕ(jI]jJ]jK]jL]jN]ujPMùj<]rÖ(jZXGThe architecture of the computer being used to build the package, e.g. r×…rØ}rÙ(jAXGThe architecture of the computer being used to build the package, e.g. jBjÓubjz)rÚ}rÛ(jAX``i386``jG}rÜ(jI]jJ]jK]jL]jN]ujBjÓj<]rÝjZXi386rÞ…rß}rà(jAUjBjÚubajEj‚ubjZX, rá…râ}rã(jAX, räjBjÓubjz)rå}ræ(jAX ``x86_64``jG}rç(jI]jJ]jK]jL]jN]ujBjÓj<]rèjZXx86_64ré…rê}rë(jAUjBjåubajEj‚ubjZX, rì…rí}rî(jAjäjBjÓubjz)rï}rð(jAX``ppc``jG}rñ(jI]jJ]jK]jL]jN]ujBjÓj<]ròjZXppcró…rô}rõ(jAUjBjïubajEj‚ubjZX or rö…r÷}rø(jAX or jBjÓubjz)rù}rú(jAX ``sparc``jG}rû(jI]jJ]jK]jL]jN]ujBjÓj<]rüjZXsparcrý…rþ}rÿ(jAUjBjùubajEj‚ubeubajEjöubeubjÐ)r}r(jAX§$abitag An optional tag that a compiler can use for telling incompatible ABI's on the same architecture apart. GHCJS encodes the underlying GHC version in the ABI tag.jBjËjCjDjEjÓjG}r(jI]jJ]jK]jL]jN]ujPMýjQhj<]r(jÖ)r}r(jAX$abitagrjBjjCjDjEjÚjG}r(jI]jJ]jK]jL]jN]ujPMýj<]rjZX$abitagr …r }r (jAjjBjubaubjà)r }r (jAUjG}r(jI]jJ]jK]jL]jN]ujBjj<]rjq)r}r(jAXŸAn optional tag that a compiler can use for telling incompatible ABI's on the same architecture apart. GHCJS encodes the underlying GHC version in the ABI tag.rjBj jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMüj<]rjZX¡An optional tag that a compiler can use for telling incompatible ABI’s on the same architecture apart. GHCJS encodes the underlying GHC version in the ABI tag.r…r}r(jAjjBjubaubajEjöubeubjÐ)r}r(jAXñ$abi A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as ``$arch-$os-compiler-$abitag`` if the compiler uses an abi tag, ``$arch-$os-$compiler`` if it doesn't. jBjËjCjDjEjÓjG}r(jI]jJ]jK]jL]jN]ujPMjQhj<]r(jÖ)r}r(jAX$abirjBjjCjDjEjÚjG}r(jI]jJ]jK]jL]jN]ujPMj<]r jZX$abir!…r"}r#(jAjjBjubaubjà)r$}r%(jAUjG}r&(jI]jJ]jK]jL]jN]ujBjj<]r'jq)r(}r)(jAXëA shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as ``$arch-$os-compiler-$abitag`` if the compiler uses an abi tag, ``$arch-$os-$compiler`` if it doesn't.jBj$jCjDjEjtjG}r*(jI]jJ]jK]jL]jN]ujPMj<]r+(jZX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as r,…r-}r.(jAX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as jBj(ubjz)r/}r0(jAX``$arch-$os-compiler-$abitag``jG}r1(jI]jJ]jK]jL]jN]ujBj(j<]r2jZX$arch-$os-compiler-$abitagr3…r4}r5(jAUjBj/ubajEj‚ubjZX" if the compiler uses an abi tag, r6…r7}r8(jAX" if the compiler uses an abi tag, jBj(ubjz)r9}r:(jAX``$arch-$os-$compiler``jG}r;(jI]jJ]jK]jL]jN]ujBj(j<]r<jZX$arch-$os-$compilerr=…r>}r?(jAUjBj9ubajEj‚ubjZX if it doesn’t.r@…rA}rB(jAX if it doesn't.jBj(ubeubajEjöubeubeubeubj>)rC}rD(jAUjBjí jCjDjEjFjG}rE(jI]jJ]jK]jL]rFhäajN]rGhBaujPMjQhj<]rH(jS)rI}rJ(jAX Paths in the simple build systemrKjBjCjCjDjEjWjG}rL(jI]jJ]jK]jL]jN]ujPMjQhj<]rMjZX Paths in the simple build systemrN…rO}rP(jAjKjCNjPNjQhjBjIubaubjq)rQ}rR(jAX:For the simple build system, the following defaults apply:rSjBjCjCjDjEjtjG}rT(jI]jJ]jK]jL]jN]ujPMjQhj<]rUjZX:For the simple build system, the following defaults apply:rV…rW}rX(jAjSjCNjPNjQhjBjQubaubcdocutils.nodes table rY)rZ}r[(jAUjBjCjCNjEUtabler\jG}r](jI]jJ]jK]jL]r^Uid11r_ajN]ujPNjQhj<]r`(jS)ra}rb(jAXDefault installation pathsrcjBjZjCjDjEjWjG}rd(jI]jJ]jK]jL]jN]ujPM j<]rejZXDefault installation pathsrf…rg}rh(jAjcjBjaubaubcdocutils.nodes tgroup ri)rj}rk(jAUjG}rl(jL]jK]jI]jJ]jN]UcolsKujBjZj<]rm(cdocutils.nodes colspec rn)ro}rp(jAUjG}rq(jL]jK]jI]jJ]jN]UcolwidthrrK!ujBjjj<]jEUcolspecrsubjn)rt}ru(jAUjG}rv(jL]jK]jI]jJ]jN]jrK!ujBjjj<]jEjsubjn)rw}rx(jAUjG}ry(jL]jK]jI]jJ]jN]jrK!ujBjjj<]jEjsubcdocutils.nodes tbody rz)r{}r|(jAUjG}r}(jI]jJ]jK]jL]jN]ujBjjj<]r~(cdocutils.nodes row r)r€}r(jAUjG}r‚(jI]jJ]jK]jL]jN]ujBj{j<]rƒ(cdocutils.nodes entry r„)r…}r†(jAUjG}r‡(jI]jJ]jK]jL]jN]ujBj€j<]rˆjq)r‰}rŠ(jAXOptionr‹jBj…jCjDjEjtjG}rŒ(jI]jJ]jK]jL]jN]ujPM j<]rjZXOptionrŽ…r}r(jAj‹jBj‰ubaubajEUentryr‘ubj„)r’}r“(jAUjG}r”(jI]jJ]jK]jL]jN]ujBj€j<]r•jq)r–}r—(jAX Unix Defaultr˜jBj’jCjDjEjtjG}r™(jI]jJ]jK]jL]jN]ujPM j<]ršjZX Unix Defaultr›…rœ}r(jAj˜jBj–ubaubajEj‘ubj„)rž}rŸ(jAUjG}r (jI]jJ]jK]jL]jN]ujBj€j<]r¡jq)r¢}r£(jAXWindows Defaultr¤jBjžjCjDjEjtjG}r¥(jI]jJ]jK]jL]jN]ujPMj<]r¦jZXWindows Defaultr§…r¨}r©(jAj¤jBj¢ubaubajEj‘ubejEUrowrªubj)r«}r¬(jAUjG}r­(jI]jJ]jK]jL]jN]ujBj{j<]r®(j„)r¯}r°(jAUjG}r±(jI]jJ]jK]jL]jN]ujBj«j<]r²jq)r³}r´(jAX:option:`--prefix` (global)rµjBj¯jCjDjEjtjG}r¶(jI]jJ]jK]jL]jN]ujPMj<]r·(j¥)r¸}r¹(jAX:option:`--prefix`rºjBj³jCjDjEj©jG}r»(UreftypeXoptionj«ˆj¬X--prefixU refdomainXstdr¼jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]r½jz)r¾}r¿(jAjºjG}rÀ(jI]jJ]rÁ(j¶j¼X std-optionrÂejK]jL]jN]ujBj¸j<]rÃjZX--prefixrÄ…rÅ}rÆ(jAUjBj¾ubajEj‚ubaubjZX (global)rÇ…rÈ}rÉ(jAX (global)jBj³ubeubajEj‘ubj„)rÊ}rË(jAUjG}rÌ(jI]jJ]jK]jL]jN]ujBj«j<]rÍjq)rÎ}rÏ(jAX``/usr/local``rÐjBjÊjCjDjEjtjG}rÑ(jI]jJ]jK]jL]jN]ujPMj<]rÒjz)rÓ}rÔ(jAjÐjG}rÕ(jI]jJ]jK]jL]jN]ujBjÎj<]rÖjZX /usr/localr×…rØ}rÙ(jAUjBjÓubajEj‚ubaubajEj‘ubj„)rÚ}rÛ(jAUjG}rÜ(jI]jJ]jK]jL]jN]ujBj«j<]rÝjq)rÞ}rß(jAX``%PROGRAMFILES%\Haskell``ràjBjÚjCjDjEjtjG}rá(jI]jJ]jK]jL]jN]ujPMj<]râjz)rã}rä(jAX``%PROGRAMFILES%\Haskell``jG}rå(jI]jJ]jK]jL]jN]ujBjÞj<]ræjZX%PROGRAMFILES%\Haskellrç…rè}ré(jAUjBjãubajEj‚ubaubajEj‘ubejEjªubj)rê}rë(jAUjG}rì(jI]jJ]jK]jL]jN]ujBj{j<]rí(j„)rî}rï(jAUjG}rð(jI]jJ]jK]jL]jN]ujBjêj<]rñjq)rò}ró(jAX:option:`--prefix` (per-user)rôjBjîjCjDjEjtjG}rõ(jI]jJ]jK]jL]jN]ujPMj<]rö(j¥)r÷}rø(jAX:option:`--prefix`rùjBjòjCjDjEj©jG}rú(UreftypeXoptionj«ˆj¬X--prefixU refdomainXstdrûjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]rüjz)rý}rþ(jAjùjG}rÿ(jI]jJ]r(j¶jûX std-optionrejK]jL]jN]ujBj÷j<]rjZX--prefixr…r}r(jAUjBjýubajEj‚ubaubjZX (per-user)r…r}r(jAX (per-user)jBjòubeubajEj‘ubj„)r }r (jAUjG}r (jI]jJ]jK]jL]jN]ujBjêj<]r jq)r }r(jAX``$HOME/.cabal``rjBj jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMj<]rjz)r}r(jAjjG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZX $HOME/.cabalr…r}r(jAUjBjubajEj‚ubaubajEj‘ubj„)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBjêj<]rjq)r}r(jAX``%APPDATA%\cabal``rjBjjCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPMj<]r!jz)r"}r#(jAX``%APPDATA%\cabal``jG}r$(jI]jJ]jK]jL]jN]ujBjj<]r%jZX%APPDATA%\cabalr&…r'}r((jAUjBj"ubajEj‚ubaubajEj‘ubejEjªubj)r)}r*(jAUjG}r+(jI]jJ]jK]jL]jN]ujBj{j<]r,(j„)r-}r.(jAUjG}r/(jI]jJ]jK]jL]jN]ujBj)j<]r0jq)r1}r2(jAX:option:`--bindir`r3jBj-jCjDjEjtjG}r4(jI]jJ]jK]jL]jN]ujPMj<]r5j¥)r6}r7(jAj3jBj1jCjDjEj©jG}r8(UreftypeXoptionj«ˆj¬X--bindirU refdomainXstdr9jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]r:jz)r;}r<(jAj3jG}r=(jI]jJ]r>(j¶j9X std-optionr?ejK]jL]jN]ujBj6j<]r@jZX--bindirrA…rB}rC(jAUjBj;ubajEj‚ubaubaubajEj‘ubj„)rD}rE(jAUjG}rF(jI]jJ]jK]jL]jN]ujBj)j<]rGjq)rH}rI(jAX``$prefix/bin``rJjBjDjCjDjEjtjG}rK(jI]jJ]jK]jL]jN]ujPMj<]rLjz)rM}rN(jAjJjG}rO(jI]jJ]jK]jL]jN]ujBjHj<]rPjZX $prefix/binrQ…rR}rS(jAUjBjMubajEj‚ubaubajEj‘ubj„)rT}rU(jAUjG}rV(jI]jJ]jK]jL]jN]ujBj)j<]rWjq)rX}rY(jAX``$prefix\bin``rZjBjTjCjDjEjtjG}r[(jI]jJ]jK]jL]jN]ujPMj<]r\jz)r]}r^(jAX``$prefix\bin``jG}r_(jI]jJ]jK]jL]jN]ujBjXj<]r`jZX $prefix\binra…rb}rc(jAUjBj]ubajEj‚ubaubajEj‘ubejEjªubj)rd}re(jAUjG}rf(jI]jJ]jK]jL]jN]ujBj{j<]rg(j„)rh}ri(jAUjG}rj(jI]jJ]jK]jL]jN]ujBjdj<]rkjq)rl}rm(jAX:option:`--libdir`rnjBjhjCjDjEjtjG}ro(jI]jJ]jK]jL]jN]ujPMj<]rpj¥)rq}rr(jAjnjBjljCjDjEj©jG}rs(UreftypeXoptionj«ˆj¬X--libdirU refdomainXstdrtjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]rujz)rv}rw(jAjnjG}rx(jI]jJ]ry(j¶jtX std-optionrzejK]jL]jN]ujBjqj<]r{jZX--libdirr|…r}}r~(jAUjBjvubajEj‚ubaubaubajEj‘ubj„)r}r€(jAUjG}r(jI]jJ]jK]jL]jN]ujBjdj<]r‚jq)rƒ}r„(jAX``$prefix/lib``r…jBjjCjDjEjtjG}r†(jI]jJ]jK]jL]jN]ujPMj<]r‡jz)rˆ}r‰(jAj…jG}rŠ(jI]jJ]jK]jL]jN]ujBjƒj<]r‹jZX $prefix/librŒ…r}rŽ(jAUjBjˆubajEj‚ubaubajEj‘ubj„)r}r(jAUjG}r‘(jI]jJ]jK]jL]jN]ujBjdj<]r’jq)r“}r”(jAX ``$prefix``r•jBjjCjDjEjtjG}r–(jI]jJ]jK]jL]jN]ujPMj<]r—jz)r˜}r™(jAj•jG}rš(jI]jJ]jK]jL]jN]ujBj“j<]r›jZX$prefixrœ…r}rž(jAUjBj˜ubajEj‚ubaubajEj‘ubejEjªubj)rŸ}r (jAUjG}r¡(jI]jJ]jK]jL]jN]ujBj{j<]r¢(j„)r£}r¤(jAUjG}r¥(jI]jJ]jK]jL]jN]ujBjŸj<]r¦jq)r§}r¨(jAX:option:`--libsubdir` (others)r©jBj£jCjDjEjtjG}rª(jI]jJ]jK]jL]jN]ujPMj<]r«(j¥)r¬}r­(jAX:option:`--libsubdir`r®jBj§jCjDjEj©jG}r¯(UreftypeXoptionj«ˆj¬X --libsubdirU refdomainXstdr°jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]r±jz)r²}r³(jAj®jG}r´(jI]jJ]rµ(j¶j°X std-optionr¶ejK]jL]jN]ujBj¬j<]r·jZX --libsubdirr¸…r¹}rº(jAUjBj²ubajEj‚ubaubjZX (others)r»…r¼}r½(jAX (others)jBj§ubeubajEj‘ubj„)r¾}r¿(jAUjG}rÀ(jI]jJ]jK]jL]jN]ujBjŸj<]rÁjq)rÂ}rÃ(jAX``$pkgid/$compiler``rÄjBj¾jCjDjEjtjG}rÅ(jI]jJ]jK]jL]jN]ujPMj<]rÆjz)rÇ}rÈ(jAjÄjG}rÉ(jI]jJ]jK]jL]jN]ujBjÂj<]rÊjZX$pkgid/$compilerrË…rÌ}rÍ(jAUjBjÇubajEj‚ubaubajEj‘ubj„)rÎ}rÏ(jAUjG}rÐ(jI]jJ]jK]jL]jN]ujBjŸj<]rÑjq)rÒ}rÓ(jAX``$pkgid\$compiler``rÔjBjÎjCjDjEjtjG}rÕ(jI]jJ]jK]jL]jN]ujPMj<]rÖjz)r×}rØ(jAX``$pkgid\$compiler``jG}rÙ(jI]jJ]jK]jL]jN]ujBjÒj<]rÚjZX$pkgid\$compilerrÛ…rÜ}rÝ(jAUjBj×ubajEj‚ubaubajEj‘ubejEjªubj)rÞ}rß(jAUjG}rà(jI]jJ]jK]jL]jN]ujBj{j<]rá(j„)râ}rã(jAUjG}rä(jI]jJ]jK]jL]jN]ujBjÞj<]råjq)ræ}rç(jAX:option:`--dynlibdir`rèjBjâjCjDjEjtjG}ré(jI]jJ]jK]jL]jN]ujPMj<]rêj¥)rë}rì(jAjèjBjæjCjDjEj©jG}rí(UreftypeXoptionj«ˆj¬X --dynlibdirU refdomainXstdrîjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]rïjz)rð}rñ(jAjèjG}rò(jI]jJ]ró(j¶jîX std-optionrôejK]jL]jN]ujBjëj<]rõjZX --dynlibdirrö…r÷}rø(jAUjBjðubajEj‚ubaubaubajEj‘ubj„)rù}rú(jAUjG}rû(jI]jJ]jK]jL]jN]ujBjÞj<]rüjq)rý}rþ(jAX``$libdir/$abi``rÿjBjùjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPMj<]rjz)r}r(jAjÿjG}r(jI]jJ]jK]jL]jN]ujBjýj<]rjZX $libdir/$abir…r}r(jAUjBjubajEj‚ubaubajEj‘ubj„)r }r (jAUjG}r (jI]jJ]jK]jL]jN]ujBjÞj<]r jq)r }r(jAX``$libdir\$abi``rjBj jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM j<]rjz)r}r(jAX``$libdir\$abi``jG}r(jI]jJ]jK]jL]jN]ujBj j<]rjZX $libdir\$abir…r}r(jAUjBjubajEj‚ubaubajEj‘ubejEjªubj)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBj{j<]r(j„)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBjj<]r jq)r!}r"(jAX:option:`--libexecdir`r#jBjjCjDjEjtjG}r$(jI]jJ]jK]jL]jN]ujPM!j<]r%j¥)r&}r'(jAj#jBj!jCjDjEj©jG}r((UreftypeXoptionj«ˆj¬X --libexecdirU refdomainXstdr)jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM!j<]r*jz)r+}r,(jAj#jG}r-(jI]jJ]r.(j¶j)X std-optionr/ejK]jL]jN]ujBj&j<]r0jZX --libexecdirr1…r2}r3(jAUjBj+ubajEj‚ubaubaubajEj‘ubj„)r4}r5(jAUjG}r6(jI]jJ]jK]jL]jN]ujBjj<]r7jq)r8}r9(jAX``$prefix/libexec``r:jBj4jCjDjEjtjG}r;(jI]jJ]jK]jL]jN]ujPM"j<]r<jz)r=}r>(jAj:jG}r?(jI]jJ]jK]jL]jN]ujBj8j<]r@jZX$prefix/libexecrA…rB}rC(jAUjBj=ubajEj‚ubaubajEj‘ubj„)rD}rE(jAUjG}rF(jI]jJ]jK]jL]jN]ujBjj<]rGjq)rH}rI(jAX``$prefix\$pkgid``rJjBjDjCjDjEjtjG}rK(jI]jJ]jK]jL]jN]ujPM#j<]rLjz)rM}rN(jAX``$prefix\$pkgid``jG}rO(jI]jJ]jK]jL]jN]ujBjHj<]rPjZX$prefix\$pkgidrQ…rR}rS(jAUjBjMubajEj‚ubaubajEj‘ubejEjªubj)rT}rU(jAUjG}rV(jI]jJ]jK]jL]jN]ujBj{j<]rW(j„)rX}rY(jAUjG}rZ(jI]jJ]jK]jL]jN]ujBjTj<]r[jq)r\}r](jAX :option:`--datadir` (executable)r^jBjXjCjDjEjtjG}r_(jI]jJ]jK]jL]jN]ujPM$j<]r`(j¥)ra}rb(jAX:option:`--datadir`rcjBj\jCjDjEj©jG}rd(UreftypeXoptionj«ˆj¬X --datadirU refdomainXstdrejL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM$j<]rfjz)rg}rh(jAjcjG}ri(jI]jJ]rj(j¶jeX std-optionrkejK]jL]jN]ujBjaj<]rljZX --datadirrm…rn}ro(jAUjBjgubajEj‚ubaubjZX (executable)rp…rq}rr(jAX (executable)jBj\ubeubajEj‘ubj„)rs}rt(jAUjG}ru(jI]jJ]jK]jL]jN]ujBjTj<]rvjq)rw}rx(jAX``$prefix/share``ryjBjsjCjDjEjtjG}rz(jI]jJ]jK]jL]jN]ujPM%j<]r{jz)r|}r}(jAjyjG}r~(jI]jJ]jK]jL]jN]ujBjwj<]rjZX $prefix/sharer€…r}r‚(jAUjBj|ubajEj‚ubaubajEj‘ubj„)rƒ}r„(jAUjG}r…(jI]jJ]jK]jL]jN]ujBjTj<]r†jq)r‡}rˆ(jAX ``$prefix``r‰jBjƒjCjDjEjtjG}rŠ(jI]jJ]jK]jL]jN]ujPM&j<]r‹jz)rŒ}r(jAj‰jG}rŽ(jI]jJ]jK]jL]jN]ujBj‡j<]rjZX$prefixr…r‘}r’(jAUjBjŒubajEj‚ubaubajEj‘ubejEjªubj)r“}r”(jAUjG}r•(jI]jJ]jK]jL]jN]ujBj{j<]r–(j„)r—}r˜(jAUjG}r™(jI]jJ]jK]jL]jN]ujBj“j<]ršjq)r›}rœ(jAX:option:`--datadir` (library)rjBj—jCjDjEjtjG}rž(jI]jJ]jK]jL]jN]ujPM'j<]rŸ(j¥)r }r¡(jAX:option:`--datadir`r¢jBj›jCjDjEj©jG}r£(UreftypeXoptionj«ˆj¬X --datadirU refdomainXstdr¤jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM'j<]r¥jz)r¦}r§(jAj¢jG}r¨(jI]jJ]r©(j¶j¤X std-optionrªejK]jL]jN]ujBj j<]r«jZX --datadirr¬…r­}r®(jAUjBj¦ubajEj‚ubaubjZX (library)r¯…r°}r±(jAX (library)jBj›ubeubajEj‘ubj„)r²}r³(jAUjG}r´(jI]jJ]jK]jL]jN]ujBj“j<]rµjq)r¶}r·(jAX``$prefix/share``r¸jBj²jCjDjEjtjG}r¹(jI]jJ]jK]jL]jN]ujPM(j<]rºjz)r»}r¼(jAj¸jG}r½(jI]jJ]jK]jL]jN]ujBj¶j<]r¾jZX $prefix/sharer¿…rÀ}rÁ(jAUjBj»ubajEj‚ubaubajEj‘ubj„)rÂ}rÃ(jAUjG}rÄ(jI]jJ]jK]jL]jN]ujBj“j<]rÅjq)rÆ}rÇ(jAX``%PROGRAMFILES%\Haskell``rÈjBjÂjCjDjEjtjG}rÉ(jI]jJ]jK]jL]jN]ujPM)j<]rÊjz)rË}rÌ(jAX``%PROGRAMFILES%\Haskell``jG}rÍ(jI]jJ]jK]jL]jN]ujBjÆj<]rÎjZX%PROGRAMFILES%\HaskellrÏ…rÐ}rÑ(jAUjBjËubajEj‚ubaubajEj‘ubejEjªubj)rÒ}rÓ(jAUjG}rÔ(jI]jJ]jK]jL]jN]ujBj{j<]rÕ(j„)rÖ}r×(jAUjG}rØ(jI]jJ]jK]jL]jN]ujBjÒj<]rÙjq)rÚ}rÛ(jAX:option:`--datasubdir`rÜjBjÖjCjDjEjtjG}rÝ(jI]jJ]jK]jL]jN]ujPM*j<]rÞj¥)rß}rà(jAjÜjBjÚjCjDjEj©jG}rá(UreftypeXoptionj«ˆj¬X --datasubdirU refdomainXstdrâjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM*j<]rãjz)rä}rå(jAjÜjG}ræ(jI]jJ]rç(j¶jâX std-optionrèejK]jL]jN]ujBjßj<]réjZX --datasubdirrê…rë}rì(jAUjBjäubajEj‚ubaubaubajEj‘ubj„)rí}rî(jAUjG}rï(jI]jJ]jK]jL]jN]ujBjÒj<]rðjq)rñ}rò(jAX ``$pkgid``rójBjíjCjDjEjtjG}rô(jI]jJ]jK]jL]jN]ujPM+j<]rõjz)rö}r÷(jAjójG}rø(jI]jJ]jK]jL]jN]ujBjñj<]rùjZX$pkgidrú…rû}rü(jAUjBjöubajEj‚ubaubajEj‘ubj„)rý}rþ(jAUjG}rÿ(jI]jJ]jK]jL]jN]ujBjÒj<]rjq)r}r(jAX ``$pkgid``rjBjýjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM,j<]rjz)r}r(jAjjG}r(jI]jJ]jK]jL]jN]ujBjj<]r jZX$pkgidr …r }r (jAUjBjubajEj‚ubaubajEj‘ubejEjªubj)r }r(jAUjG}r(jI]jJ]jK]jL]jN]ujBj{j<]r(j„)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBj j<]rjq)r}r(jAX:option:`--docdir`rjBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM-j<]rj¥)r}r(jAjjBjjCjDjEj©jG}r(UreftypeXoptionj«ˆj¬X--docdirU refdomainXstdrjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM-j<]rjz)r}r (jAjjG}r!(jI]jJ]r"(j¶jX std-optionr#ejK]jL]jN]ujBjj<]r$jZX--docdirr%…r&}r'(jAUjBjubajEj‚ubaubaubajEj‘ubj„)r(}r)(jAUjG}r*(jI]jJ]jK]jL]jN]ujBj j<]r+jq)r,}r-(jAX``$datadir/doc/$pkgid``r.jBj(jCjDjEjtjG}r/(jI]jJ]jK]jL]jN]ujPM.j<]r0jz)r1}r2(jAj.jG}r3(jI]jJ]jK]jL]jN]ujBj,j<]r4jZX$datadir/doc/$pkgidr5…r6}r7(jAUjBj1ubajEj‚ubaubajEj‘ubj„)r8}r9(jAUjG}r:(jI]jJ]jK]jL]jN]ujBj j<]r;jq)r<}r=(jAX``$prefix\doc\$pkgid``r>jBj8jCjDjEjtjG}r?(jI]jJ]jK]jL]jN]ujPM/j<]r@jz)rA}rB(jAX``$prefix\doc\$pkgid``jG}rC(jI]jJ]jK]jL]jN]ujBj<j<]rDjZX$prefix\doc\$pkgidrE…rF}rG(jAUjBjAubajEj‚ubaubajEj‘ubejEjªubj)rH}rI(jAUjG}rJ(jI]jJ]jK]jL]jN]ujBj{j<]rK(j„)rL}rM(jAUjG}rN(jI]jJ]jK]jL]jN]ujBjHj<]rOjq)rP}rQ(jAX:option:`--sysconfdir`rRjBjLjCjDjEjtjG}rS(jI]jJ]jK]jL]jN]ujPM0j<]rTj¥)rU}rV(jAjRjBjPjCjDjEj©jG}rW(UreftypeXoptionj«ˆj¬X --sysconfdirU refdomainXstdrXjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM0j<]rYjz)rZ}r[(jAjRjG}r\(jI]jJ]r](j¶jXX std-optionr^ejK]jL]jN]ujBjUj<]r_jZX --sysconfdirr`…ra}rb(jAUjBjZubajEj‚ubaubaubajEj‘ubj„)rc}rd(jAUjG}re(jI]jJ]jK]jL]jN]ujBjHj<]rfjq)rg}rh(jAX``$prefix/etc``rijBjcjCjDjEjtjG}rj(jI]jJ]jK]jL]jN]ujPM1j<]rkjz)rl}rm(jAjijG}rn(jI]jJ]jK]jL]jN]ujBjgj<]rojZX $prefix/etcrp…rq}rr(jAUjBjlubajEj‚ubaubajEj‘ubj„)rs}rt(jAUjG}ru(jI]jJ]jK]jL]jN]ujBjHj<]rvjq)rw}rx(jAX``$prefix\etc``ryjBjsjCjDjEjtjG}rz(jI]jJ]jK]jL]jN]ujPM2j<]r{jz)r|}r}(jAX``$prefix\etc``jG}r~(jI]jJ]jK]jL]jN]ujBjwj<]rjZX $prefix\etcr€…r}r‚(jAUjBj|ubajEj‚ubaubajEj‘ubejEjªubj)rƒ}r„(jAUjG}r…(jI]jJ]jK]jL]jN]ujBj{j<]r†(j„)r‡}rˆ(jAUjG}r‰(jI]jJ]jK]jL]jN]ujBjƒj<]rŠjq)r‹}rŒ(jAX:option:`--htmldir`rjBj‡jCjDjEjtjG}rŽ(jI]jJ]jK]jL]jN]ujPM3j<]rj¥)r}r‘(jAjjBj‹jCjDjEj©jG}r’(UreftypeXoptionj«ˆj¬X --htmldirU refdomainXstdr“jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM3j<]r”jz)r•}r–(jAjjG}r—(jI]jJ]r˜(j¶j“X std-optionr™ejK]jL]jN]ujBjj<]ršjZX --htmldirr›…rœ}r(jAUjBj•ubajEj‚ubaubaubajEj‘ubj„)rž}rŸ(jAUjG}r (jI]jJ]jK]jL]jN]ujBjƒj<]r¡jq)r¢}r£(jAX``$docdir/html``r¤jBjžjCjDjEjtjG}r¥(jI]jJ]jK]jL]jN]ujPM4j<]r¦jz)r§}r¨(jAj¤jG}r©(jI]jJ]jK]jL]jN]ujBj¢j<]rªjZX $docdir/htmlr«…r¬}r­(jAUjBj§ubajEj‚ubaubajEj‘ubj„)r®}r¯(jAUjG}r°(jI]jJ]jK]jL]jN]ujBjƒj<]r±jq)r²}r³(jAX``$docdir\html``r´jBj®jCjDjEjtjG}rµ(jI]jJ]jK]jL]jN]ujPM5j<]r¶jz)r·}r¸(jAX``$docdir\html``jG}r¹(jI]jJ]jK]jL]jN]ujBj²j<]rºjZX $docdir\htmlr»…r¼}r½(jAUjBj·ubajEj‚ubaubajEj‘ubejEjªubj)r¾}r¿(jAUjG}rÀ(jI]jJ]jK]jL]jN]ujBj{j<]rÁ(j„)rÂ}rÃ(jAUjG}rÄ(jI]jJ]jK]jL]jN]ujBj¾j<]rÅjq)rÆ}rÇ(jAX:option:`--program-prefix`rÈjBjÂjCjDjEjtjG}rÉ(jI]jJ]jK]jL]jN]ujPM6j<]rÊj¥)rË}rÌ(jAjÈjBjÆjCjDjEj©jG}rÍ(UreftypeXoptionj«ˆj¬X--program-prefixU refdomainXstdrÎjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM6j<]rÏjz)rÐ}rÑ(jAjÈjG}rÒ(jI]jJ]rÓ(j¶jÎX std-optionrÔejK]jL]jN]ujBjËj<]rÕjZX--program-prefixrÖ…r×}rØ(jAUjBjÐubajEj‚ubaubaubajEj‘ubj„)rÙ}rÚ(jAUjG}rÛ(jI]jJ]jK]jL]jN]ujBj¾j<]rÜjq)rÝ}rÞ(jAX(empty)rßjBjÙjCjDjEjtjG}rà(jI]jJ]jK]jL]jN]ujPM7j<]rájZX(empty)râ…rã}rä(jAjßjBjÝubaubajEj‘ubj„)rå}ræ(jAUjG}rç(jI]jJ]jK]jL]jN]ujBj¾j<]rèjq)ré}rê(jAX(empty)rëjBjåjCjDjEjtjG}rì(jI]jJ]jK]jL]jN]ujPM8j<]ríjZX(empty)rî…rï}rð(jAjëjBjéubaubajEj‘ubejEjªubj)rñ}rò(jAUjG}ró(jI]jJ]jK]jL]jN]ujBj{j<]rô(j„)rõ}rö(jAUjG}r÷(jI]jJ]jK]jL]jN]ujBjñj<]røjq)rù}rú(jAX:option:`--program-suffix`rûjBjõjCjDjEjtjG}rü(jI]jJ]jK]jL]jN]ujPM9j<]rýj¥)rþ}rÿ(jAjûjBjùjCjDjEj©jG}r(UreftypeXoptionj«ˆj¬X--program-suffixU refdomainXstdrjL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM9j<]rjz)r}r(jAjûjG}r(jI]jJ]r(j¶jX std-optionrejK]jL]jN]ujBjþj<]rjZX--program-suffixr …r }r (jAUjBjubajEj‚ubaubaubajEj‘ubj„)r }r (jAUjG}r(jI]jJ]jK]jL]jN]ujBjñj<]rjq)r}r(jAX(empty)rjBj jCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM:j<]rjZX(empty)r…r}r(jAjjBjubaubajEj‘ubj„)r}r(jAUjG}r(jI]jJ]jK]jL]jN]ujBjñj<]rjq)r}r(jAX(empty)rjBjjCjDjEjtjG}r(jI]jJ]jK]jL]jN]ujPM;j<]r jZX(empty)r!…r"}r#(jAjjBjubaubajEj‘ubejEjªubejEUtbodyr$ubejEUtgroupr%ubeubeubj>)r&}r'(jAUjBjí jCjDjEjFjG}r((jI]jJ]jK]jL]r)hÝajN]r*h:aujPM>jQhj<]r+(jS)r,}r-(jAXPrefix-independencer.jBj&jCjDjEjWjG}r/(jI]jJ]jK]jL]jN]ujPM>jQhj<]r0jZXPrefix-independencer1…r2}r3(jAj.jCNjPNjQhjBj,ubaubjq)r4}r5(jAXOn Windows it is possible to obtain the pathname of the running program. This means that we can construct an installable executable package that is independent of its absolute install location. The executable can find its auxiliary files by finding its own path and knowing the location of the other files relative to ``$bindir``. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of ``$prefix``) at install-time, rather than having to bake the path into the binary when it is built.jBj&jCjDjEjtjG}r6(jI]jJ]jK]jL]jN]ujPM@jQhj<]r7(jZX>On Windows it is possible to obtain the pathname of the running program. This means that we can construct an installable executable package that is independent of its absolute install location. The executable can find its auxiliary files by finding its own path and knowing the location of the other files relative to r8…r9}r:(jAX>On Windows it is possible to obtain the pathname of the running program. This means that we can construct an installable executable package that is independent of its absolute install location. The executable can find its auxiliary files by finding its own path and knowing the location of the other files relative to jCNjPNjQhjBj4ubjz)r;}r<(jAX ``$bindir``jG}r=(jI]jJ]jK]jL]jN]ujBj4j<]r>jZX$bindirr?…r@}rA(jAUjBj;ubajEj‚ubjZXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of rB…rC}rD(jAXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of jCNjPNjQhjBj4ubjz)rE}rF(jAX ``$prefix``jG}rG(jI]jJ]jK]jL]jN]ujBj4j<]rHjZX$prefixrI…rJ}rK(jAUjBjEubajEj‚ubjZXX) at install-time, rather than having to bake the path into the binary when it is built.rL…rM}rN(jAXX) at install-time, rather than having to bake the path into the binary when it is built.jCNjPNjQhjBj4ubeubjq)rO}rP(jAX In order to achieve this, we require that for an executable on Windows, all of ``$bindir``, ``$libdir``, ``$dynlibdir``, ``$datadir`` and ``$libexecdir`` begin with ``$prefix``. If this is not the case then the compiled executable will have baked-in all absolute paths.jBj&jCjDjEjtjG}rQ(jI]jJ]jK]jL]jN]ujPMIjQhj<]rR(jZXOIn order to achieve this, we require that for an executable on Windows, all of rS…rT}rU(jAXOIn order to achieve this, we require that for an executable on Windows, all of jCNjPNjQhjBjOubjz)rV}rW(jAX ``$bindir``jG}rX(jI]jJ]jK]jL]jN]ujBjOj<]rYjZX$bindirrZ…r[}r\(jAUjBjVubajEj‚ubjZX, r]…r^}r_(jAX, r`jCNjPNjQhjBjOubjz)ra}rb(jAX ``$libdir``jG}rc(jI]jJ]jK]jL]jN]ujBjOj<]rdjZX$libdirre…rf}rg(jAUjBjaubajEj‚ubjZX, rh…ri}rj(jAX, jBjOubjz)rk}rl(jAX``$dynlibdir``jG}rm(jI]jJ]jK]jL]jN]ujBjOj<]rnjZX $dynlibdirro…rp}rq(jAUjBjkubajEj‚ubjZX, rr…rs}rt(jAj`jBjOubjz)ru}rv(jAX ``$datadir``jG}rw(jI]jJ]jK]jL]jN]ujBjOj<]rxjZX$datadirry…rz}r{(jAUjBjuubajEj‚ubjZX and r|…r}}r~(jAX and jCNjPNjQhjBjOubjz)r}r€(jAX``$libexecdir``jG}r(jI]jJ]jK]jL]jN]ujBjOj<]r‚jZX $libexecdirrƒ…r„}r…(jAUjBjubajEj‚ubjZX begin with r†…r‡}rˆ(jAX begin with jCNjPNjQhjBjOubjz)r‰}rŠ(jAX ``$prefix``jG}r‹(jI]jJ]jK]jL]jN]ujBjOj<]rŒjZX$prefixr…rŽ}r(jAUjBj‰ubajEj‚ubjZX]. If this is not the case then the compiled executable will have baked-in all absolute paths.r…r‘}r’(jAX]. If this is not the case then the compiled executable will have baked-in all absolute paths.jCNjPNjQhjBjOubeubjq)r“}r”(jAX>The application need do nothing special to achieve prefix-independence. If it finds any files using ``getDataFileName`` and the `other functions provided for the purpose `__, the files will be accessed relative to the location of the current executable.jBj&jCjDjEjtjG}r•(jI]jJ]jK]jL]jN]ujPMNjQhj<]r–(jZXdThe application need do nothing special to achieve prefix-independence. If it finds any files using r—…r˜}r™(jAXdThe application need do nothing special to achieve prefix-independence. If it finds any files using jCNjPNjQhjBj“ubjz)rš}r›(jAX``getDataFileName``jG}rœ(jI]jJ]jK]jL]jN]ujBj“j<]rjZXgetDataFileNamerž…rŸ}r (jAUjBjšubajEj‚ubjZX and the r¡…r¢}r£(jAX and the jCNjPNjQhjBj“ubj”)r¤}r¥(jAXn`other functions provided for the purpose `__jG}r¦(UnameX(other functions provided for the purposejâX?developing-packages.html#accessing-data-files-from-package-codejL]jK]jI]jJ]jN]ujBj“j<]r§jZX(other functions provided for the purposer¨…r©}rª(jAUjBj¤ubajEjubjZXP, the files will be accessed relative to the location of the current executable.r«…r¬}r­(jAXP, the files will be accessed relative to the location of the current executable.jCNjPNjQhjBj“ubeubjq)r®}r¯(jAX¥A library cannot (currently) be prefix-independent, because it will be linked into an executable whose file system location bears no relation to the library package.r°jBj&jCjDjEjtjG}r±(jI]jJ]jK]jL]jN]ujPMUjQhj<]r²jZX¥A library cannot (currently) be prefix-independent, because it will be linked into an executable whose file system location bears no relation to the library package.r³…r´}rµ(jAj°jCNjPNjQhjBj®ubaubeubeubj>)r¶}r·(jAUjBj\jCjDjEjFjG}r¸(jI]jJ]jK]jL]r¹j0ajN]rºh”aujPMZjQhj<]r»(jS)r¼}r½(jAXControlling Flag Assignmentsr¾jBj¶jCjDjEjWjG}r¿(jI]jJ]jK]jL]jN]ujPMZjQhj<]rÀjZXControlling Flag AssignmentsrÁ…rÂ}rÃ(jAj¾jCNjPNjQhjBj¼ubaubjq)rÄ}rÅ(jAXºFlag assignments (see the `resolution of conditions and flags `__) can be controlled with the following command line options.jBj¶jCjDjEjtjG}rÆ(jI]jJ]jK]jL]jN]ujPM\jQhj<]rÇ(jZXFlag assignments (see the rÈ…rÉ}rÊ(jAXFlag assignments (see the jCNjPNjQhjBjÄubj”)rË}rÌ(jAXd`resolution of conditions and flags `__jG}rÍ(UnameX"resolution of conditions and flagsjâX;developing-packages.html#resolution-of-conditions-and-flagsjL]jK]jI]jJ]jN]ujBjÄj<]rÎjZX"resolution of conditions and flagsrÏ…rÐ}rÑ(jAUjBjËubajEjubjZX<) can be controlled with the following command line options.rÒ…rÓ}rÔ(jAX<) can be controlled with the following command line options.jCNjPNjQhjBjÄubeubjŠ)rÕ}rÖ(jAUjBj¶jCjDjEjjG}r×(jL]jK]jI]jJ]jN]Uentries]rØ(jX@setup-configure command line option; -f flagname or -f -flagnamej:UNtrÙaujPNjQhj<]ubj’)rÚ}rÛ(jAUjBj¶jCjDjEj•jG}rÜ(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÝj›jÝujPNjQhj<]rÞ(j)rß}rà(jAX-f flagname or -f -flagnamejBjÚjCjDjEj jG}rá(j¢]râX-frãajL]räj:ajK]jI]jJ]jN]råhžaj¨‰ujPMfjQhj<]ræ(jª)rç}rè(jAjãjBjßjCjDjEj­jG}ré(jµj¶jL]jK]jI]jJ]jN]ujPMfjQhj<]rêjZX-frë…rì}rí(jAUjCNjPNjQhjBjçubaubj³)rî}rï(jAX flagname or -f -flagnamejBjßjCjDjEj¶jG}rð(jµj¶jL]jK]jI]jJ]jN]ujPMfjQhj<]rñjZX flagname or -f -flagnamerò…ró}rô(jAUjCNjPNjQhjBjîubaubeubjÎ)rõ}rö(jAUjBjÚjCjDjEjÑjG}r÷(jI]jJ]jK]jL]jN]ujPMfjQhj<]røjq)rù}rú(jAXÐForce the specified flag to ``true`` or ``false`` (if preceded with a ``-``). Later specifications for the same flags will override earlier, i.e., specifying ``-fdebug -f-debug`` is equivalent to ``-f-debug``jBjõjCjDjEjtjG}rû(jI]jJ]jK]jL]jN]ujPMbjQhj<]rü(jZXForce the specified flag to rý…rþ}rÿ(jAXForce the specified flag to jCNjPNjQhjBjùubjz)r}r(jAX``true``jG}r(jI]jJ]jK]jL]jN]ujBjùj<]rjZXtruer…r}r(jAUjBjubajEj‚ubjZX or r…r}r (jAX or jCNjPNjQhjBjùubjz)r }r (jAX ``false``jG}r (jI]jJ]jK]jL]jN]ujBjùj<]r jZXfalser…r}r(jAUjBj ubajEj‚ubjZX (if preceded with a r…r}r(jAX (if preceded with a jCNjPNjQhjBjùubjz)r}r(jAX``-``jG}r(jI]jJ]jK]jL]jN]ujBjùj<]rjZX-…r}r(jAUjBjubajEj‚ubjZXS). Later specifications for the same flags will override earlier, i.e., specifying r…r}r(jAXS). Later specifications for the same flags will override earlier, i.e., specifying jCNjPNjQhjBjùubjz)r}r(jAX``-fdebug -f-debug``jG}r(jI]jJ]jK]jL]jN]ujBjùj<]r jZX-fdebug -f-debugr!…r"}r#(jAUjBjubajEj‚ubjZX is equivalent to r$…r%}r&(jAX is equivalent to jCNjPNjQhjBjùubjz)r'}r((jAX ``-f-debug``jG}r)(jI]jJ]jK]jL]jN]ujBjùj<]r*jZX-f-debugr+…r,}r-(jAUjBj'ubajEj‚ubeubaubeubjŠ)r.}r/(jAUjBj¶jCjDjEjjG}r0(jL]jK]jI]jJ]jN]Uentries]r1(jX6setup-configure command line option; --flags=flagspecsjUNtr2aujPNjQhj<]ubj’)r3}r4(jAUjBj¶jCjDjEj•jG}r5(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr6j›j6ujPNjQhj<]r7(j)r8}r9(jAX--flags=flagspecsjBj3jCjDjEj jG}r:(j¢]r;X--flagsr<ajL]r=jajK]jI]jJ]jN]r>hoaj¨‰ujPMojQhj<]r?(jª)r@}rA(jAj<jBj8jCjDjEj­jG}rB(jµj¶jL]jK]jI]jJ]jN]ujPMojQhj<]rCjZX--flagsrD…rE}rF(jAUjCNjPNjQhjBj@ubaubj³)rG}rH(jAX =flagspecsjBj8jCjDjEj¶jG}rI(jµj¶jL]jK]jI]jJ]jN]ujPMojQhj<]rJjZX =flagspecsrK…rL}rM(jAUjCNjPNjQhjBjGubaubeubjÎ)rN}rO(jAUjBj3jCjDjEjÑjG}rP(jI]jJ]jK]jL]jN]ujPMojQhj<]rQjq)rR}rS(jAXESame as ``-f``, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to ``true``), optionally preceded by a ``-`` (to force a flag to ``false``). For example, ``--flags="debug -feature1 feature2"`` is equivalent to ``-fdebug -f-feature1 -ffeature2``.jBjNjCjDjEjtjG}rT(jI]jJ]jK]jL]jN]ujPMijQhj<]rU(jZXSame as rV…rW}rX(jAXSame as jCNjPNjQhjBjRubjz)rY}rZ(jAX``-f``jG}r[(jI]jJ]jK]jL]jN]ujBjRj<]r\jZX-fr]…r^}r_(jAUjBjYubajEj‚ubjZX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to r`…ra}rb(jAX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to jCNjPNjQhjBjRubjz)rc}rd(jAX``true``jG}re(jI]jJ]jK]jL]jN]ujBjRj<]rfjZXtruerg…rh}ri(jAUjBjcubajEj‚ubjZX), optionally preceded by a rj…rk}rl(jAX), optionally preceded by a jCNjPNjQhjBjRubjz)rm}rn(jAX``-``jG}ro(jI]jJ]jK]jL]jN]ujBjRj<]rpjZX-…rq}rr(jAUjBjmubajEj‚ubjZX (to force a flag to rs…rt}ru(jAX (to force a flag to jCNjPNjQhjBjRubjz)rv}rw(jAX ``false``jG}rx(jI]jJ]jK]jL]jN]ujBjRj<]ryjZXfalserz…r{}r|(jAUjBjvubajEj‚ubjZX). For example, r}…r~}r(jAX). For example, jCNjPNjQhjBjRubjz)r€}r(jAX&``--flags="debug -feature1 feature2"``jG}r‚(jI]jJ]jK]jL]jN]ujBjRj<]rƒjZX"--flags="debug -feature1 feature2"r„…r…}r†(jAUjBj€ubajEj‚ubjZX is equivalent to r‡…rˆ}r‰(jAX is equivalent to jCNjPNjQhjBjRubjz)rŠ}r‹(jAX"``-fdebug -f-feature1 -ffeature2``jG}rŒ(jI]jJ]jK]jL]jN]ujBjRj<]rjZX-fdebug -f-feature1 -ffeature2rŽ…r}r(jAUjBjŠubajEj‚ubjZX.…r‘}r’(jAX.jCNjPNjQhjBjRubeubaubeubeubj>)r“}r”(jAUjBj\jCjDjEjFjG}r•(jI]jJ]jK]jL]r–hÄajN]r—h!aujPMqjQhj<]r˜(jS)r™}rš(jAXBuilding Test Suitesr›jBj“jCjDjEjWjG}rœ(jI]jJ]jK]jL]jN]ujPMqjQhj<]rjZXBuilding Test Suitesrž…rŸ}r (jAj›jCNjPNjQhjBj™ubaubjŠ)r¡}r¢(jAUjBj“jCjDjEjjG}r£(jL]jK]jI]jJ]jN]Uentries]r¤(jX3setup-configure command line option; --enable-testsj1UNtr¥aujPNjQhj<]ubj’)r¦}r§(jAUjBj“jCjDjEj•jG}r¨(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr©j›j©ujPNjQhj<]rª(j)r«}r¬(jAX--enable-testsr­jBj¦jCjDjEj jG}r®(j¢]r¯j­ajL]r°j1ajK]jI]jJ]jN]r±h•aj¨‰ujPMzjQhj<]r²(jª)r³}r´(jAj­jBj«jCjDjEj­jG}rµ(jµj¶jL]jK]jI]jJ]jN]ujPMzjQhj<]r¶jZX--enable-testsr·…r¸}r¹(jAUjCNjPNjQhjBj³ubaubj³)rº}r»(jAUjBj«jCjDjEj¶jG}r¼(jµj¶jL]jK]jI]jJ]jN]ujPMzjQhj<]ubeubjÎ)r½}r¾(jAUjBj¦jCjDjEjÑjG}r¿(jI]jJ]jK]jL]jN]ujPMzjQhj<]rÀjq)rÁ}rÂ(jAXBuild the test suites defined in the package description file during the ``build`` stage. Check for dependencies required by the test suites. If the package is configured with this option, it will be possible to run the test suites with the ``test`` command after the package is built.jBj½jCjDjEjtjG}rÃ(jI]jJ]jK]jL]jN]ujPMujQhj<]rÄ(jZXIBuild the test suites defined in the package description file during the rÅ…rÆ}rÇ(jAXIBuild the test suites defined in the package description file during the jCNjPNjQhjBjÁubjz)rÈ}rÉ(jAX ``build``jG}rÊ(jI]jJ]jK]jL]jN]ujBjÁj<]rËjZXbuildrÌ…rÍ}rÎ(jAUjBjÈubajEj‚ubjZXŸ stage. Check for dependencies required by the test suites. If the package is configured with this option, it will be possible to run the test suites with the rÏ…rÐ}rÑ(jAXŸ stage. Check for dependencies required by the test suites. If the package is configured with this option, it will be possible to run the test suites with the jCNjPNjQhjBjÁubjz)rÒ}rÓ(jAX``test``jG}rÔ(jI]jJ]jK]jL]jN]ujBjÁj<]rÕjZXtestrÖ…r×}rØ(jAUjBjÒubajEj‚ubjZX$ command after the package is built.rÙ…rÚ}rÛ(jAX$ command after the package is built.jCNjPNjQhjBjÁubeubaubeubjŠ)rÜ}rÝ(jAUjBj“jCjDjEjjG}rÞ(jL]jK]jI]jJ]jN]Uentries]rß(jX4setup-configure command line option; --disable-testsj2UNtràaujPNjQhj<]ubj’)rá}râ(jAUjBj“jCjDjEj•jG}rã(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionräj›jäujPNjQhj<]rå(j)ræ}rç(jAX--disable-testsrèjBjájCjDjEj jG}ré(j¢]rêjèajL]rëj2ajK]jI]jJ]jN]rìh–aj¨‰ujPMjQhj<]rí(jª)rî}rï(jAjèjBjæjCjDjEj­jG}rð(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rñjZX--disable-testsrò…ró}rô(jAUjCNjPNjQhjBjîubaubj³)rõ}rö(jAUjBjæjCjDjEj¶jG}r÷(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]ubeubjÎ)rø}rù(jAUjBjájCjDjEjÑjG}rú(jI]jJ]jK]jL]jN]ujPMjQhj<]rûjq)rü}rý(jAXÜ(default) Do not build any test suites during the ``build`` stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the ``test`` command without reconfiguring the package.jBjøjCjDjEjtjG}rþ(jI]jJ]jK]jL]jN]ujPM}jQhj<]rÿ(jZX2(default) Do not build any test suites during the r…r}r(jAX2(default) Do not build any test suites during the jCNjPNjQhjBjüubjz)r}r(jAX ``build``jG}r(jI]jJ]jK]jL]jN]ujBjüj<]rjZXbuildr…r}r (jAUjBjubajEj‚ubjZXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the r …r }r (jAXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the jCNjPNjQhjBjüubjz)r }r(jAX``test``jG}r(jI]jJ]jK]jL]jN]ujBjüj<]rjZXtestr…r}r(jAUjBj ubajEj‚ubjZX+ command without reconfiguring the package.r…r}r(jAX+ command without reconfiguring the package.jCNjPNjQhjBjüubeubaubeubjŠ)r}r(jAUjBj“jCjDjEjjG}r(jL]jK]jI]jJ]jN]Uentries]r(jX6setup-configure command line option; --enable-coveragehøUNtraujPNjQhj<]ubj’)r}r(jAUjBj“jCjDjEj•jG}r(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrj›jujPNjQhj<]r (j)r!}r"(jAX--enable-coverager#jBjjCjDjEj jG}r$(j¢]r%j#ajL]r&høajK]jI]jJ]jN]r'hVaj¨‰ujPM‡jQhj<]r((jª)r)}r*(jAj#jBj!jCjDjEj­jG}r+(jµj¶jL]jK]jI]jJ]jN]ujPM‡jQhj<]r,jZX--enable-coverager-…r.}r/(jAUjCNjPNjQhjBj)ubaubj³)r0}r1(jAUjBj!jCjDjEj¶jG}r2(jµj¶jL]jK]jI]jJ]jN]ujPM‡jQhj<]ubeubjÎ)r3}r4(jAUjBjjCjDjEjÑjG}r5(jI]jJ]jK]jL]jN]ujPM‡jQhj<]r6jq)r7}r8(jAX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.r9jBj3jCjDjEjtjG}r:(jI]jJ]jK]jL]jN]ujPM„jQhj<]r;jZX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.r<…r=}r>(jAj9jCNjPNjQhjBj7ubaubaubeubjŠ)r?}r@(jAUjBj“jCjDjEjjG}rA(jL]jK]jI]jJ]jN]Uentries]rB(jX7setup-configure command line option; --disable-coveragejUNtrCaujPNjQhj<]ubj’)rD}rE(jAUjBj“jCjDjEj•jG}rF(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrGj›jGujPNjQhj<]rH(j)rI}rJ(jAX--disable-coveragerKjBjDjCjDjEj jG}rL(j¢]rMjKajL]rNjajK]jI]jJ]jN]rOhwaj¨‰ujPM‹jQhj<]rP(jª)rQ}rR(jAjKjBjIjCjDjEj­jG}rS(jµj¶jL]jK]jI]jJ]jN]ujPM‹jQhj<]rTjZX--disable-coveragerU…rV}rW(jAUjCNjPNjQhjBjQubaubj³)rX}rY(jAUjBjIjCjDjEj¶jG}rZ(jµj¶jL]jK]jI]jJ]jN]ujPM‹jQhj<]ubeubjÎ)r[}r\(jAUjBjDjCjDjEjÑjG}r](jI]jJ]jK]jL]jN]ujPM‹jQhj<]r^jq)r_}r`(jAX1(default) Do not enable Haskell Program Coverage.rajBj[jCjDjEjtjG}rb(jI]jJ]jK]jL]jN]ujPMŠjQhj<]rcjZX1(default) Do not enable Haskell Program Coverage.rd…re}rf(jAjajCNjPNjQhjBj_ubaubaubeubeubj>)rg}rh(jAUjBj\jCjDjEjFjG}ri(jI]jJ]jK]jL]rjh¾ajN]rkhaujPMjQhj<]rl(jS)rm}rn(jAXMiscellaneous optionsrojBjgjCjDjEjWjG}rp(jI]jJ]jK]jL]jN]ujPMjQhj<]rqjZXMiscellaneous optionsrr…rs}rt(jAjojCNjPNjQhjBjmubaubjŠ)ru}rv(jAUjBjgjCjDjEjjG}rw(jL]jK]jI]jJ]jN]Uentries]rx(jX+setup-configure command line option; --userhðUNtryaujPNjQhj<]ubj’)rz}r{(jAUjBjgjCjDjEj•jG}r|(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr}j›j}ujPNjQhj<]r~(j)r}r€(jAX--userrjBjzjCjDjEj jG}r‚(j¢]rƒjajL]r„hðajK]jI]jJ]jN]r…hNaj¨‰ujPM˜jQhj<]r†(jª)r‡}rˆ(jAjjBjjCjDjEj­jG}r‰(jµj¶jL]jK]jI]jJ]jN]ujPM˜jQhj<]rŠjZX--userr‹…rŒ}r(jAUjCNjPNjQhjBj‡ubaubj³)rŽ}r(jAUjBjjCjDjEj¶jG}r(jµj¶jL]jK]jI]jJ]jN]ujPM˜jQhj<]ubeubjÎ)r‘}r’(jAUjBjzjCjDjEjÑjG}r“(jI]jJ]jK]jL]jN]ujPM˜jQhj<]r”jq)r•}r–(jAX¡Does a per-user installation. This changes the `default installation prefix <#paths-in-the-simple-build-system>`__. It also allow dependencies to be satisfied by the user's package database, in addition to the global database. This also implies a default of ``--user`` for any subsequent ``install`` command, as packages registered in the global database should not depend on packages registered in a user's database.jBj‘jCjDjEjtjG}r—(jI]jJ]jK]jL]jN]ujPM‘jQhj<]r˜(jZX/Does a per-user installation. This changes the r™…rš}r›(jAX/Does a per-user installation. This changes the jCNjPNjQhjBj•ubj”)rœ}r(jAXC`default installation prefix <#paths-in-the-simple-build-system>`__jG}rž(UnameXdefault installation prefixjâX!#paths-in-the-simple-build-systemjL]jK]jI]jJ]jN]ujBj•j<]rŸjZXdefault installation prefixr …r¡}r¢(jAUjBjœubajEjubjZX’. It also allow dependencies to be satisfied by the user’s package database, in addition to the global database. This also implies a default of r£…r¤}r¥(jAX. It also allow dependencies to be satisfied by the user's package database, in addition to the global database. This also implies a default of jCNjPNjQhjBj•ubjz)r¦}r§(jAX ``--user``jG}r¨(jI]jJ]jK]jL]jN]ujBj•j<]r©jZX--userrª…r«}r¬(jAUjBj¦ubajEj‚ubjZX for any subsequent r­…r®}r¯(jAX for any subsequent jCNjPNjQhjBj•ubjz)r°}r±(jAX ``install``jG}r²(jI]jJ]jK]jL]jN]ujBj•j<]r³jZXinstallr´…rµ}r¶(jAUjBj°ubajEj‚ubjZXx command, as packages registered in the global database should not depend on packages registered in a user’s database.r·…r¸}r¹(jAXv command, as packages registered in the global database should not depend on packages registered in a user's database.jCNjPNjQhjBj•ubeubaubeubjŠ)rº}r»(jAUjBjgjCjDjEjjG}r¼(jL]jK]jI]jJ]jN]Uentries]r½(jX-setup-configure command line option; --globalh´UNtr¾aujPNjQhj<]ubj’)r¿}rÀ(jAUjBjgjCjDjEj•jG}rÁ(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÂj›jÂujPNjQhj<]rÃ(j)rÄ}rÅ(jAX--globalrÆjBj¿jCjDjEj jG}rÇ(j¢]rÈjÆajL]rÉh´ajK]jI]jJ]jN]rÊhaj¨‰ujPMŸjQhj<]rË(jª)rÌ}rÍ(jAjÆjBjÄjCjDjEj­jG}rÎ(jµj¶jL]jK]jI]jJ]jN]ujPMŸjQhj<]rÏjZX--globalrÐ…rÑ}rÒ(jAUjCNjPNjQhjBjÌubaubj³)rÓ}rÔ(jAUjBjÄjCjDjEj¶jG}rÕ(jµj¶jL]jK]jI]jJ]jN]ujPMŸjQhj<]ubeubjÎ)rÖ}r×(jAUjBj¿jCjDjEjÑjG}rØ(jI]jJ]jK]jL]jN]ujPMŸjQhj<]rÙjq)rÚ}rÛ(jAX(default) Does a global installation. In this case package dependencies must be satisfied by the global package database. All packages in the user's package database will be ignored. Typically the final installation step will require administrative privileges.rÜjBjÖjCjDjEjtjG}rÝ(jI]jJ]jK]jL]jN]ujPM›jQhj<]rÞjZX(default) Does a global installation. In this case package dependencies must be satisfied by the global package database. All packages in the user’s package database will be ignored. Typically the final installation step will require administrative privileges.rß…rà}rá(jAjÜjCNjPNjQhjBjÚubaubaubeubjŠ)râ}rã(jAUjBjgjCjDjEjjG}rä(jL]jK]jI]jJ]jN]Uentries]rå(jX4setup-configure command line option; --package-db=dbjUNtræaujPNjQhj<]ubj’)rç}rè(jAUjBjgjCjDjEj•jG}ré(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrêj›jêujPNjQhj<]rë(j)rì}rí(jAX--package-db=dbjBjçjCjDjEj jG}rî(j¢]rïX --package-dbrðajL]rñjajK]jI]jJ]jN]ròhbaj¨‰ujPM±jQhj<]ró(jª)rô}rõ(jAjðjBjìjCjDjEj­jG}rö(jµj¶jL]jK]jI]jJ]jN]ujPM±jQhj<]r÷jZX --package-dbrø…rù}rú(jAUjCNjPNjQhjBjôubaubj³)rû}rü(jAX=dbjBjìjCjDjEj¶jG}rý(jµj¶jL]jK]jI]jJ]jN]ujPM±jQhj<]rþjZX=dbrÿ…r }r (jAUjCNjPNjQhjBjûubaubeubjÎ)r }r (jAUjBjçjCjDjEjÑjG}r (jI]jJ]jK]jL]jN]ujPM±jQhj<]r (jq)r }r (jAX]Allows package dependencies to be satisfied from this additional package database *db* in addition to the global package database. All packages in the user's package database will be ignored. The interpretation of *db* is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.jBj jCjDjEjtjG}r (jI]jJ]jK]jL]jN]ujPM¢jQhj<]r (jZXRAllows package dependencies to be satisfied from this additional package database r …r }r (jAXRAllows package dependencies to be satisfied from this additional package database jCNjPNjQhjBj ubjµ)r }r (jAX*db*jG}r (jI]jJ]jK]jL]jN]ujBj j<]r jZXdbr …r }r (jAUjBj ubajEj½ubjZX‚ in addition to the global package database. All packages in the user’s package database will be ignored. The interpretation of r …r }r (jAX€ in addition to the global package database. All packages in the user's package database will be ignored. The interpretation of jCNjPNjQhjBj ubjµ)r }r (jAX*db*jG}r (jI]jJ]jK]jL]jN]ujBj j<]r jZXdbr …r }r (jAUjBj ubajEj½ubjZXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.r …r }r (jAXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.jCNjPNjQhjBj ubeubjq)r! }r" (jAXbThis pushes an extra db onto the db stack. The :option:`--global` and :option:`--user` mode switches add the respective [Global] and [Global, User] dbs to the initial stack. There is a compiler-implementation constraint that the global db must appear first in the stack, and if the user one appears at all, it must appear immediately after the global db.jBj jCjDjEjtjG}r# (jI]jJ]jK]jL]jN]ujPM©jQhj<]r$ (jZX/This pushes an extra db onto the db stack. The r% …r& }r' (jAX/This pushes an extra db onto the db stack. The jCNjPNjQhjBj! ubj¥)r( }r) (jAX:option:`--global`r* jBj! jCjDjEj©jG}r+ (UreftypeXoptionj«ˆj¬X--globalU refdomainXstdr, jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM©j<]r- jz)r. }r/ (jAj* jG}r0 (jI]jJ]r1 (j¶j, X std-optionr2 ejK]jL]jN]ujBj( j<]r3 jZX--globalr4 …r5 }r6 (jAUjBj. ubajEj‚ubaubjZX and r7 …r8 }r9 (jAX and jCNjPNjQhjBj! ubj¥)r: }r; (jAX:option:`--user`r< jBj! jCjDjEj©jG}r= (UreftypeXoptionj«ˆj¬X--userU refdomainXstdr> jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM©j<]r? jz)r@ }rA (jAj< jG}rB (jI]jJ]rC (j¶j> X std-optionrD ejK]jL]jN]ujBj: j<]rE jZX--userrF …rG }rH (jAUjBj@ ubajEj‚ubaubjZX  mode switches add the respective [Global] and [Global, User] dbs to the initial stack. There is a compiler-implementation constraint that the global db must appear first in the stack, and if the user one appears at all, it must appear immediately after the global db.rI …rJ }rK (jAX  mode switches add the respective [Global] and [Global, User] dbs to the initial stack. There is a compiler-implementation constraint that the global db must appear first in the stack, and if the user one appears at all, it must appear immediately after the global db.jCNjPNjQhjBj! ubeubjq)rL }rM (jAX/To reset the stack, use ``--package-db=clear``.jBj jCjDjEjtjG}rN (jI]jJ]jK]jL]jN]ujPM°jQhj<]rO (jZXTo reset the stack, use rP …rQ }rR (jAXTo reset the stack, use jCNjPNjQhjBjL ubjz)rS }rT (jAX``--package-db=clear``jG}rU (jI]jJ]jK]jL]jN]ujBjL j<]rV jZX--package-db=clearrW …rX }rY (jAUjBjS ubajEj‚ubjZX.…rZ }r[ (jAX.jCNjPNjQhjBjL ubeubeubeubjŠ)r\ }r] (jAUjBjgjCjDjEjjG}r^ (jL]jK]jI]jJ]jN]Uentries]r_ (jX0setup-configure command line option; --ipid=ipidjUNtr` aujPNjQhj<]ubj’)ra }rb (jAUjBjgjCjDjEj•jG}rc (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrd j›jd ujPNjQhj<]re (j)rf }rg (jAX --ipid=ipidjBja jCjDjEj jG}rh (j¢]ri X--ipidrj ajL]rk jajK]jI]jJ]jN]rl haaj¨‰ujPM»jQhj<]rm (jª)rn }ro (jAjj jBjf jCjDjEj­jG}rp (jµj¶jL]jK]jI]jJ]jN]ujPM»jQhj<]rq jZX--ipidrr …rs }rt (jAUjCNjPNjQhjBjn ubaubj³)ru }rv (jAX=ipidjBjf jCjDjEj¶jG}rw (jµj¶jL]jK]jI]jJ]jN]ujPM»jQhj<]rx jZX=ipidry …rz }r{ (jAUjCNjPNjQhjBju ubaubeubjÎ)r| }r} (jAUjBja jCjDjEjÑjG}r~ (jI]jJ]jK]jL]jN]ujPM»jQhj<]r jq)r€ }r (jAX¢Specifies the *installed package identifier* of the package to be built; this identifier is passed on to GHC and serves as the basis for linker symbols and the ``id`` field in a ``ghc-pkg`` registration. When a package has multiple components, the actual component identifiers are derived off of this identifier (e.g., an internal library ``foo`` from package ``p-0.1-abcd`` will get the identifier ``p-0.1-abcd-foo``.jBj| jCjDjEjtjG}r‚ (jI]jJ]jK]jL]jN]ujPM´jQhj<]rƒ (jZXSpecifies the r„ …r… }r† (jAXSpecifies the jCNjPNjQhjBj€ ubjµ)r‡ }rˆ (jAX*installed package identifier*jG}r‰ (jI]jJ]jK]jL]jN]ujBj€ j<]rŠ jZXinstalled package identifierr‹ …rŒ }r (jAUjBj‡ ubajEj½ubjZXt of the package to be built; this identifier is passed on to GHC and serves as the basis for linker symbols and the rŽ …r }r (jAXt of the package to be built; this identifier is passed on to GHC and serves as the basis for linker symbols and the jCNjPNjQhjBj€ ubjz)r‘ }r’ (jAX``id``jG}r“ (jI]jJ]jK]jL]jN]ujBj€ j<]r” jZXidr• …r– }r— (jAUjBj‘ ubajEj‚ubjZX field in a r˜ …r™ }rš (jAX field in a jCNjPNjQhjBj€ ubjz)r› }rœ (jAX ``ghc-pkg``jG}r (jI]jJ]jK]jL]jN]ujBj€ j<]rž jZXghc-pkgrŸ …r  }r¡ (jAUjBj› ubajEj‚ubjZX– registration. When a package has multiple components, the actual component identifiers are derived off of this identifier (e.g., an internal library r¢ …r£ }r¤ (jAX– registration. When a package has multiple components, the actual component identifiers are derived off of this identifier (e.g., an internal library jCNjPNjQhjBj€ ubjz)r¥ }r¦ (jAX``foo``jG}r§ (jI]jJ]jK]jL]jN]ujBj€ j<]r¨ jZXfoor© …rª }r« (jAUjBj¥ ubajEj‚ubjZX from package r¬ …r­ }r® (jAX from package jCNjPNjQhjBj€ ubjz)r¯ }r° (jAX``p-0.1-abcd``jG}r± (jI]jJ]jK]jL]jN]ujBj€ j<]r² jZX p-0.1-abcdr³ …r´ }rµ (jAUjBj¯ ubajEj‚ubjZX will get the identifier r¶ …r· }r¸ (jAX will get the identifier jCNjPNjQhjBj€ ubjz)r¹ }rº (jAX``p-0.1-abcd-foo``jG}r» (jI]jJ]jK]jL]jN]ujBj€ j<]r¼ jZXp-0.1-abcd-foor½ …r¾ }r¿ (jAUjBj¹ ubajEj‚ubjZX.…rÀ }rÁ (jAX.jCNjPNjQhjBj€ ubeubaubeubjŠ)r }rà (jAUjBjgjCjDjEjjG}rÄ (jL]jK]jI]jJ]jN]Uentries]rÅ (jX.setup-configure command line option; --cid=cidh©UNtrÆ aujPNjQhj<]ubj’)rÇ }rÈ (jAUjBjgjCjDjEj•jG}rÉ (j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÊ j›jÊ ujPNjQhj<]rË (j)rÌ }rÍ (jAX --cid=cidjBjÇ jCjDjEj jG}rÎ (j¢]rÏ X--cidrÐ ajL]rÑ h©ajK]jI]jJ]jN]rÒ haj¨‰ujPMÀjQhj<]rÓ (jª)rÔ }rÕ (jAjÐ jBjÌ jCjDjEj­jG}rÖ (jµj¶jL]jK]jI]jJ]jN]ujPMÀjQhj<]r× jZX--cidrØ …rÙ }rÚ (jAUjCNjPNjQhjBjÔ ubaubj³)rÛ }rÜ (jAX=cidjBjÌ jCjDjEj¶jG}rÝ (jµj¶jL]jK]jI]jJ]jN]ujPMÀjQhj<]rÞ jZX=cidrß …rà }rá (jAUjCNjPNjQhjBjÛ ubaubeubjÎ)râ }rã (jAUjBjÇ jCjDjEjÑjG}rä (jI]jJ]jK]jL]jN]ujPMÀjQhj<]rå jq)ræ }rç (jAX€Specifies the *component identifier* of the component being built; this is only valid if you are configuring a single component.jBjâ jCjDjEjtjG}rè (jI]jJ]jK]jL]jN]ujPM¾jQhj<]ré (jZXSpecifies the rê …rë }rì (jAXSpecifies the jCNjPNjQhjBjæ ubjµ)rí }rî (jAX*component identifier*jG}rï (jI]jJ]jK]jL]jN]ujBjæ j<]rð jZXcomponent identifierrñ …rò }ró (jAUjBjí ubajEj½ubjZX\ of the component being built; this is only valid if you are configuring a single component.rô …rõ }rö (jAX\ of the component being built; this is only valid if you are configuring a single component.jCNjPNjQhjBjæ ubeubaubeubjŠ)r÷ }rø (jAUjBjgjCjDjEjjG}rù (jL]jK]jI]jJ]jN]Uentries]rú (jX?setup-configure command line option; --default-user-config=filehÍUNtrû aujPNjQhj<]ubj’)rü }rý (jAUjBjgjCjDjEj•jG}rþ (j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrÿ j›jÿ ujPNjQhj<]r!(j)r!}r!(jAX--default-user-config=filejBjü jCjDjEj jG}r!(j¢]r!X--default-user-configr!ajL]r!hÍajK]jI]jJ]jN]r!h*aj¨‰ujPMÉjQhj<]r!(jª)r !}r !(jAj!jBj!jCjDjEj­jG}r !(jµj¶jL]jK]jI]jJ]jN]ujPMÉjQhj<]r !jZX--default-user-configr !…r!}r!(jAUjCNjPNjQhjBj !ubaubj³)r!}r!(jAX=filejBj!jCjDjEj¶jG}r!(jµj¶jL]jK]jI]jJ]jN]ujPMÉjQhj<]r!jZX=filer!…r!}r!(jAUjCNjPNjQhjBj!ubaubeubjÎ)r!}r!(jAUjBjü jCjDjEjÑjG}r!(jI]jJ]jK]jL]jN]ujPMÉjQhj<]r!jq)r!}r!(jAXwAllows a "default" ``cabal.config`` freeze file to be passed in manually. This file will only be used if one does not exist in the project directory already. Typically, this can be set from the global cabal ``config`` file so as to provide a default set of partial constraints to be used by projects, providing a way for users to peg themselves to stable package collections.jBj!jCjDjEjtjG}r!(jI]jJ]jK]jL]jN]ujPMÃjQhj<]r!(jZXAllows a “default†r!…r !}r!!(jAXAllows a "default" jCNjPNjQhjBj!ubjz)r"!}r#!(jAX``cabal.config``jG}r$!(jI]jJ]jK]jL]jN]ujBj!j<]r%!jZX cabal.configr&!…r'!}r(!(jAUjBj"!ubajEj‚ubjZX¬ freeze file to be passed in manually. This file will only be used if one does not exist in the project directory already. Typically, this can be set from the global cabal r)!…r*!}r+!(jAX¬ freeze file to be passed in manually. This file will only be used if one does not exist in the project directory already. Typically, this can be set from the global cabal jCNjPNjQhjBj!ubjz)r,!}r-!(jAX ``config``jG}r.!(jI]jJ]jK]jL]jN]ujBj!j<]r/!jZXconfigr0!…r1!}r2!(jAUjBj,!ubajEj‚ubjZXž file so as to provide a default set of partial constraints to be used by projects, providing a way for users to peg themselves to stable package collections.r3!…r4!}r5!(jAXž file so as to provide a default set of partial constraints to be used by projects, providing a way for users to peg themselves to stable package collections.jCNjPNjQhjBj!ubeubaubeubjŠ)r6!}r7!(jAUjBjgjCjDjEjjG}r8!(jL]jK]jI]jJ]jN]Uentries]r9!(jXHsetup-configure command line option; --enable-optimization[=n] or -O [n]j UNtr:!aujPNjQhj<]ubj’)r;!}r!j›j>!ujPNjQhj<]r?!(j)r@!}rA!(jAX#--enable-optimization[=n] or -O [n]jBj;!jCjDjEj jG}rB!(j¢]rC!X--enable-optimization[rD!ajL]rE!j ajK]jI]jJ]jN]rF!hlaj¨‰ujPMÖjQhj<]rG!(jª)rH!}rI!(jAjD!jBj@!jCjDjEj­jG}rJ!(jµj¶jL]jK]jI]jJ]jN]ujPMÖjQhj<]rK!jZX--enable-optimization[rL!…rM!}rN!(jAUjCNjPNjQhjBjH!ubaubj³)rO!}rP!(jAX =n] or -O [n]jBj@!jCjDjEj¶jG}rQ!(jµj¶jL]jK]jI]jJ]jN]ujPMÖjQhj<]rR!jZX =n] or -O [n]rS!…rT!}rU!(jAUjCNjPNjQhjBjO!ubaubeubjÎ)rV!}rW!(jAUjBj;!jCjDjEjÑjG}rX!(jI]jJ]jK]jL]jN]ujPMÖjQhj<]rY!(jq)rZ!}r[!(jAX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.r\!jBjV!jCjDjEjtjG}r]!(jI]jJ]jK]jL]jN]ujPMÌjQhj<]r^!jZX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.r_!…r`!}ra!(jAj\!jCNjPNjQhjBjZ!ubaubjq)rb!}rc!(jAXtThe optional *n* value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to :option:`--disable-optimization`, level 1 is the default if no *n* parameter is given. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code.jBjV!jCjDjEjtjG}rd!(jI]jJ]jK]jL]jN]ujPMÐjQhj<]re!(jZX The optional rf!…rg!}rh!(jAX The optional jCNjPNjQhjBjb!ubjµ)ri!}rj!(jAX*n*jG}rk!(jI]jJ]jK]jL]jN]ujBjb!j<]rl!jZXn…rm!}rn!(jAUjBji!ubajEj½ubjZX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to ro!…rp!}rq!(jAX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to jCNjPNjQhjBjb!ubj¥)rr!}rs!(jAX :option:`--disable-optimization`rt!jBjb!jCjDjEj©jG}ru!(UreftypeXoptionj«ˆj¬X--disable-optimizationU refdomainXstdrv!jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÐj<]rw!jz)rx!}ry!(jAjt!jG}rz!(jI]jJ]r{!(j¶jv!X std-optionr|!ejK]jL]jN]ujBjr!j<]r}!jZX--disable-optimizationr~!…r!}r€!(jAUjBjx!ubajEj‚ubaubjZX, level 1 is the default if no r!…r‚!}rƒ!(jAX, level 1 is the default if no jCNjPNjQhjBjb!ubjµ)r„!}r…!(jAX*n*jG}r†!(jI]jJ]jK]jL]jN]ujBjb!j<]r‡!jZXn…rˆ!}r‰!(jAUjBj„!ubajEj½ubjZX parameter is given. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code.rŠ!…r‹!}rŒ!(jAX parameter is given. Level 2 is higher optimisation if the compiler supports it. Level 2 is likely to lead to longer compile times and bigger generated code.jCNjPNjQhjBjb!ubeubeubeubjŠ)r!}rŽ!(jAUjBjgjCjDjEjjG}r!(jL]jK]jI]jJ]jN]Uentries]r!(jX;setup-configure command line option; --disable-optimizationhæUNtr‘!aujPNjQhj<]ubj’)r’!}r“!(jAUjBjgjCjDjEj•jG}r”!(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr•!j›j•!ujPNjQhj<]r–!(j)r—!}r˜!(jAX--disable-optimizationr™!jBj’!jCjDjEj jG}rš!(j¢]r›!j™!ajL]rœ!hæajK]jI]jJ]jN]r!hDaj¨‰ujPMÜjQhj<]rž!(jª)rŸ!}r !(jAj™!jBj—!jCjDjEj­jG}r¡!(jµj¶jL]jK]jI]jJ]jN]ujPMÜjQhj<]r¢!jZX--disable-optimizationr£!…r¤!}r¥!(jAUjCNjPNjQhjBjŸ!ubaubj³)r¦!}r§!(jAUjBj—!jCjDjEj¶jG}r¨!(jµj¶jL]jK]jI]jJ]jN]ujPMÜjQhj<]ubeubjÎ)r©!}rª!(jAUjBj’!jCjDjEjÑjG}r«!(jI]jJ]jK]jL]jN]ujPMÜjQhj<]r¬!jq)r­!}r®!(jAX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.r¯!jBj©!jCjDjEjtjG}r°!(jI]jJ]jK]jL]jN]ujPMÙjQhj<]r±!jZX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.r²!…r³!}r´!(jAj¯!jCNjPNjQhjBj­!ubaubaubeubjŠ)rµ!}r¶!(jAUjBjgjCjDjEjjG}r·!(jL]jK]jI]jJ]jN]Uentries]r¸!(jX7setup-configure command line option; --enable-profilinghÆUNtr¹!aujPNjQhj<]ubj’)rº!}r»!(jAUjBjgjCjDjEj•jG}r¼!(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr½!j›j½!ujPNjQhj<]r¾!(j)r¿!}rÀ!(jAX--enable-profilingrÁ!jBjº!jCjDjEj jG}rÂ!(j¢]rÃ!jÁ!ajL]rÄ!hÆajK]jI]jJ]jN]rÅ!h#aj¨‰ujPMëjQhj<]rÆ!(jª)rÇ!}rÈ!(jAjÁ!jBj¿!jCjDjEj­jG}rÉ!(jµj¶jL]jK]jI]jJ]jN]ujPMëjQhj<]rÊ!jZX--enable-profilingrË!…rÌ!}rÍ!(jAUjCNjPNjQhjBjÇ!ubaubj³)rÎ!}rÏ!(jAUjBj¿!jCjDjEj¶jG}rÐ!(jµj¶jL]jK]jI]jJ]jN]ujPMëjQhj<]ubeubjÎ)rÑ!}rÒ!(jAUjBjº!jCjDjEjÑjG}rÓ!(jI]jJ]jK]jL]jN]ujPMëjQhj<]rÔ!(jq)rÕ!}rÖ!(jAX¥Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). For this to work, all libraries used by this package must also have been built with profiling support. For libraries this involves building an additional instance of the library in addition to the normal non-profiling instance. For executables it changes the single executable to be built in profiling mode.r×!jBjÑ!jCjDjEjtjG}rØ!(jI]jJ]jK]jL]jN]ujPMßjQhj<]rÙ!jZX¥Build libraries and executables with profiling enabled (for compilers that support profiling as a separate mode). For this to work, all libraries used by this package must also have been built with profiling support. For libraries this involves building an additional instance of the library in addition to the normal non-profiling instance. For executables it changes the single executable to be built in profiling mode.rÚ!…rÛ!}rÜ!(jAj×!jCNjPNjQhjBjÕ!ubaubjq)rÝ!}rÞ!(jAXxThis flag covers both libraries and executables, but can be overridden by the :option:`--enable-library-profiling` flag.jBjÑ!jCjDjEjtjG}rß!(jI]jJ]jK]jL]jN]ujPMçjQhj<]rà!(jZXNThis flag covers both libraries and executables, but can be overridden by the rá!…râ!}rã!(jAXNThis flag covers both libraries and executables, but can be overridden by the jCNjPNjQhjBjÝ!ubj¥)rä!}rå!(jAX$:option:`--enable-library-profiling`ræ!jBjÝ!jCjDjEj©jG}rç!(UreftypeXoptionj«ˆj¬X--enable-library-profilingU refdomainXstdrè!jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMçj<]ré!jz)rê!}rë!(jAjæ!jG}rì!(jI]jJ]rí!(j¶jè!X std-optionrî!ejK]jL]jN]ujBjä!j<]rï!jZX--enable-library-profilingrð!…rñ!}rò!(jAUjBjê!ubajEj‚ubaubjZX flag.ró!…rô!}rõ!(jAX flag.jCNjPNjQhjBjÝ!ubeubjq)rö!}r÷!(jAX5See also the :option:`--profiling-detail` flag below.jBjÑ!jCjDjEjtjG}rø!(jI]jJ]jK]jL]jN]ujPMêjQhj<]rù!(jZX See also the rú!…rû!}rü!(jAX See also the jCNjPNjQhjBjö!ubj¥)rý!}rþ!(jAX:option:`--profiling-detail`rÿ!jBjö!jCjDjEj©jG}r"(UreftypeXoptionj«ˆj¬X--profiling-detailU refdomainXstdr"jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMêj<]r"jz)r"}r"(jAjÿ!jG}r"(jI]jJ]r"(j¶j"X std-optionr"ejK]jL]jN]ujBjý!j<]r"jZX--profiling-detailr "…r "}r "(jAUjBj"ubajEj‚ubaubjZX flag below.r "…r "}r"(jAX flag below.jCNjPNjQhjBjö!ubeubeubeubjŠ)r"}r"(jAUjBjgjCjDjEjjG}r"(jL]jK]jI]jJ]jN]Uentries]r"(jX8setup-configure command line option; --disable-profilinghüUNtr"aujPNjQhj<]ubj’)r"}r"(jAUjBjgjCjDjEj•jG}r"(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr"j›j"ujPNjQhj<]r"(j)r"}r"(jAX--disable-profilingr"jBj"jCjDjEj jG}r"(j¢]r"j"ajL]r"hüajK]jI]jJ]jN]r"hZaj¨‰ujPMðjQhj<]r "(jª)r!"}r""(jAj"jBj"jCjDjEj­jG}r#"(jµj¶jL]jK]jI]jJ]jN]ujPMðjQhj<]r$"jZX--disable-profilingr%"…r&"}r'"(jAUjCNjPNjQhjBj!"ubaubj³)r("}r)"(jAUjBj"jCjDjEj¶jG}r*"(jµj¶jL]jK]jI]jJ]jN]ujPMðjQhj<]ubeubjÎ)r+"}r,"(jAUjBj"jCjDjEjÑjG}r-"(jI]jJ]jK]jL]jN]ujPMðjQhj<]r."jq)r/"}r0"(jAXI(default) Do not enable profiling in generated libraries and executables.r1"jBj+"jCjDjEjtjG}r2"(jI]jJ]jK]jL]jN]ujPMîjQhj<]r3"jZXI(default) Do not enable profiling in generated libraries and executables.r4"…r5"}r6"(jAj1"jCNjPNjQhjBj/"ubaubaubeubjŠ)r7"}r8"(jAUjBjgjCjDjEjjG}r9"(jL]jK]jI]jJ]jN]Uentries]r:"(jXEsetup-configure command line option; --enable-library-profiling or -ph»UNtr;"aujPNjQhj<]ubj’)r<"}r="(jAUjBjgjCjDjEj•jG}r>"(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr?"j›j?"ujPNjQhj<]r@"(j)rA"}rB"(jAX --enable-library-profiling or -pjBj<"jCjDjEj jG}rC"(j¢]rD"X--enable-library-profilingrE"ajL]rF"h»ajK]jI]jJ]jN]rG"haj¨‰ujPMûjQhj<]rH"(jª)rI"}rJ"(jAjE"jBjA"jCjDjEj­jG}rK"(jµj¶jL]jK]jI]jJ]jN]ujPMûjQhj<]rL"jZX--enable-library-profilingrM"…rN"}rO"(jAUjCNjPNjQhjBjI"ubaubj³)rP"}rQ"(jAX or -pjBjA"jCjDjEj¶jG}rR"(jµj¶jL]jK]jI]jJ]jN]ujPMûjQhj<]rS"jZX or -prT"…rU"}rV"(jAUjCNjPNjQhjBjP"ubaubeubjÎ)rW"}rX"(jAUjBj<"jCjDjEjÑjG}rY"(jI]jJ]jK]jL]jN]ujPMûjQhj<]rZ"(jq)r["}r\"(jAXÂAs with :option:`--enable-profiling` above, but it applies only for libraries. So this generates an additional profiling instance of the library in addition to the normal non-profiling instance.jBjW"jCjDjEjtjG}r]"(jI]jJ]jK]jL]jN]ujPMójQhj<]r^"(jZXAs with r_"…r`"}ra"(jAXAs with jCNjPNjQhjBj["ubj¥)rb"}rc"(jAX:option:`--enable-profiling`rd"jBj["jCjDjEj©jG}re"(UreftypeXoptionj«ˆj¬X--enable-profilingU refdomainXstdrf"jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMój<]rg"jz)rh"}ri"(jAjd"jG}rj"(jI]jJ]rk"(j¶jf"X std-optionrl"ejK]jL]jN]ujBjb"j<]rm"jZX--enable-profilingrn"…ro"}rp"(jAUjBjh"ubajEj‚ubaubjZXž above, but it applies only for libraries. So this generates an additional profiling instance of the library in addition to the normal non-profiling instance.rq"…rr"}rs"(jAXž above, but it applies only for libraries. So this generates an additional profiling instance of the library in addition to the normal non-profiling instance.jCNjPNjQhjBj["ubeubjq)rt"}ru"(jAXàThe :option:`--enable-profiling` flag controls the profiling mode for both libraries and executables, but if different modes are desired for libraries versus executables then use :option:`--enable-library-profiling` as well.jBjW"jCjDjEjtjG}rv"(jI]jJ]jK]jL]jN]ujPM÷jQhj<]rw"(jZXThe rx"…ry"}rz"(jAXThe jCNjPNjQhjBjt"ubj¥)r{"}r|"(jAX:option:`--enable-profiling`r}"jBjt"jCjDjEj©jG}r~"(UreftypeXoptionj«ˆj¬X--enable-profilingU refdomainXstdr"jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM÷j<]r€"jz)r"}r‚"(jAj}"jG}rƒ"(jI]jJ]r„"(j¶j"X std-optionr…"ejK]jL]jN]ujBj{"j<]r†"jZX--enable-profilingr‡"…rˆ"}r‰"(jAUjBj"ubajEj‚ubaubjZX“ flag controls the profiling mode for both libraries and executables, but if different modes are desired for libraries versus executables then use rŠ"…r‹"}rŒ"(jAX“ flag controls the profiling mode for both libraries and executables, but if different modes are desired for libraries versus executables then use jCNjPNjQhjBjt"ubj¥)r"}rŽ"(jAX$:option:`--enable-library-profiling`r"jBjt"jCjDjEj©jG}r"(UreftypeXoptionj«ˆj¬X--enable-library-profilingU refdomainXstdr‘"jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM÷j<]r’"jz)r“"}r”"(jAj"jG}r•"(jI]jJ]r–"(j¶j‘"X std-optionr—"ejK]jL]jN]ujBj"j<]r˜"jZX--enable-library-profilingr™"…rš"}r›"(jAUjBj“"ubajEj‚ubaubjZX as well.rœ"…r"}rž"(jAX as well.jCNjPNjQhjBjt"ubeubeubeubjŠ)rŸ"}r "(jAUjBjgjCjDjEjjG}r¡"(jL]jK]jI]jJ]jN]Uentries]r¢"(jX@setup-configure command line option; --disable-library-profilinghÛUNtr£"aujPNjQhj<]ubj’)r¤"}r¥"(jAUjBjgjCjDjEj•jG}r¦"(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr§"j›j§"ujPNjQhj<]r¨"(j)r©"}rª"(jAX--disable-library-profilingr«"jBj¤"jCjDjEj jG}r¬"(j¢]r­"j«"ajL]r®"hÛajK]jI]jJ]jN]r¯"h8aj¨‰ujPMÿjQhj<]r°"(jª)r±"}r²"(jAj«"jBj©"jCjDjEj­jG}r³"(jµj¶jL]jK]jI]jJ]jN]ujPMÿjQhj<]r´"jZX--disable-library-profilingrµ"…r¶"}r·"(jAUjCNjPNjQhjBj±"ubaubj³)r¸"}r¹"(jAUjBj©"jCjDjEj¶jG}rº"(jµj¶jL]jK]jI]jJ]jN]ujPMÿjQhj<]ubeubjÎ)r»"}r¼"(jAUjBj¤"jCjDjEjÑjG}r½"(jI]jJ]jK]jL]jN]ujPMÿjQhj<]r¾"jq)r¿"}rÀ"(jAXI(default) Do not generate an additional profiling version of the library.rÁ"jBj»"jCjDjEjtjG}rÂ"(jI]jJ]jK]jL]jN]ujPMþjQhj<]rÃ"jZXI(default) Do not generate an additional profiling version of the library.rÄ"…rÅ"}rÆ"(jAjÁ"jCNjPNjQhjBj¿"ubaubaubeubjŠ)rÇ"}rÈ"(jAUjBjgjCjDjEjjG}rÉ"(jL]jK]jI]jJ]jN]Uentries]rÊ"(jX?setup-configure command line option; --profiling-detail[=level]jUNtrË"aujPNjQhj<]ubj’)rÌ"}rÍ"(jAUjBjgjCjDjEj•jG}rÎ"(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÏ"j›jÏ"ujPNjQhj<]rÐ"(j)rÑ"}rÒ"(jAX--profiling-detail[=level]rÓ"jBjÌ"jCjDjEj jG}rÔ"(j¢]rÕ"X--profiling-detail[rÖ"ajL]r×"jajK]jI]jJ]jN]rØ"heaj¨‰ujPM$jQhj<]rÙ"(jª)rÚ"}rÛ"(jAjÖ"jBjÑ"jCjDjEj­jG}rÜ"(jµj¶jL]jK]jI]jJ]jN]ujPM$jQhj<]rÝ"jZX--profiling-detail[rÞ"…rß"}rà"(jAUjCNjPNjQhjBjÚ"ubaubj³)rá"}râ"(jAX=level]jBjÑ"jCjDjEj¶jG}rã"(jµj¶jL]jK]jI]jJ]jN]ujPM$jQhj<]rä"jZX=level]rå"…ræ"}rç"(jAUjCNjPNjQhjBjá"ubaubeubjÎ)rè"}ré"(jAUjBjÌ"jCjDjEjÑjG}rê"(jI]jJ]jK]jL]jN]ujPM$jQhj<]rë"(jq)rì"}rí"(jAXGSome 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î"jBjè"jCjDjEjtjG}rï"(jI]jJ]jK]jL]jN]ujPMjQhj<]rð"jZXKSome 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ó"(jAjî"jCNjPNjQhjBjì"ubaubjq)rô"}rõ"(jAXxThis flag covers both libraries and executables, but can be overridden by the :option:`--library-profiling-detail` flag.jBjè"jCjDjEjtjG}rö"(jI]jJ]jK]jL]jN]ujPMjQhj<]r÷"(jZXNThis flag covers both libraries and executables, but can be overridden by the rø"…rù"}rú"(jAXNThis flag covers both libraries and executables, but can be overridden by the jCNjPNjQhjBjô"ubj¥)rû"}rü"(jAX$:option:`--library-profiling-detail`rý"jBjô"jCjDjEj©jG}rþ"(UreftypeXoptionj«ˆj¬X--library-profiling-detailU refdomainXstdrÿ"jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMj<]r#jz)r#}r#(jAjý"jG}r#(jI]jJ]r#(j¶jÿ"X std-optionr#ejK]jL]jN]ujBjû"j<]r#jZX--library-profiling-detailr#…r#}r #(jAUjBj#ubajEj‚ubaubjZX flag.r #…r #}r #(jAX flag.jCNjPNjQhjBjô"ubeubjq)r #}r#(jAXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:r#jBjè"jCjDjEjtjG}r#(jI]jJ]jK]jL]jN]ujPM jQhj<]r#jZXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:r#…r#}r#(jAj#jCNjPNjQhjBj #ubaubjÊ)r#}r#(jAUjBjè"jCjDjEjÍjG}r#(jI]jJ]jK]jL]jN]ujPNjQhj<]r#(jÐ)r#}r#(jAXjdefault For GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jBj#jCjDjEjÓjG}r#(jI]jJ]jK]jL]jN]ujPMj<]r#(jÖ)r#}r#(jAXdefaultr#jBj#jCjDjEjÚjG}r #(jI]jJ]jK]jL]jN]ujPMj<]r!#jZXdefaultr"#…r##}r$#(jAj#jBj#ubaubjà)r%#}r&#(jAUjG}r'#(jI]jJ]jK]jL]jN]ujBj#j<]r(#jq)r)#}r*#(jAXbFor GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jBj%#jCjDjEjtjG}r+#(jI]jJ]jK]jL]jN]ujPMj<]r,#(jZXFor GHC this uses r-#…r.#}r/#(jAXFor GHC this uses jBj)#ubjz)r0#}r1#(jAX``exported-functions``jG}r2#(jI]jJ]jK]jL]jN]ujBj)#j<]r3#jZXexported-functionsr4#…r5#}r6#(jAUjBj0#ubajEj‚ubjZX for libraries and r7#…r8#}r9#(jAX for libraries and jBj)#ubjz)r:#}r;#(jAX``toplevel-functions``jG}r<#(jI]jJ]jK]jL]jN]ujBj)#j<]r=#jZXtoplevel-functionsr>#…r?#}r@#(jAUjBj:#ubajEj‚ubjZX for executables.rA#…rB#}rC#(jAX for executables.jBj)#ubeubajEjöubeubjÐ)rD#}rE#(jAXAnone No costs will be assigned to any code within this component.jBj#jCjDjEjÓjG}rF#(jI]jJ]jK]jL]jN]ujPMjQhj<]rG#(jÖ)rH#}rI#(jAXnonerJ#jBjD#jCjDjEjÚjG}rK#(jI]jJ]jK]jL]jN]ujPMj<]rL#jZXnonerM#…rN#}rO#(jAjJ#jBjH#ubaubjà)rP#}rQ#(jAUjG}rR#(jI]jJ]jK]jL]jN]ujBjD#j<]rS#jq)rT#}rU#(jAX<No costs will be assigned to any code within this component.rV#jBjP#jCjDjEjtjG}rW#(jI]jJ]jK]jL]jN]ujPMj<]rX#jZX<No costs will be assigned to any code within this component.rY#…rZ#}r[#(jAjV#jBjT#ubaubajEjöubeubjÐ)r\#}r]#(jAX©exported-functions Costs will be assigned at the granularity of all top level functions exported from each module. In GHC specifically, this is for non-inline functions.jBj#jCjDjEjÓjG}r^#(jI]jJ]jK]jL]jN]ujPMjQhj<]r_#(jÖ)r`#}ra#(jAXexported-functionsrb#jBj\#jCjDjEjÚjG}rc#(jI]jJ]jK]jL]jN]ujPMj<]rd#jZXexported-functionsre#…rf#}rg#(jAjb#jBj`#ubaubjà)rh#}ri#(jAUjG}rj#(jI]jJ]jK]jL]jN]ujBj\#j<]rk#jq)rl#}rm#(jAX–Costs will be assigned at the granularity of all top level functions exported from each module. In GHC specifically, this is for non-inline functions.rn#jBjh#jCjDjEjtjG}ro#(jI]jJ]jK]jL]jN]ujPMj<]rp#jZX–Costs will be assigned at the granularity of all top level functions exported from each module. In GHC specifically, this is for non-inline functions.rq#…rr#}rs#(jAjn#jBjl#ubaubajEjöubeubjÐ)rt#}ru#(jAXÐ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.jBj#jCjDjEjÓjG}rv#(jI]jJ]jK]jL]jN]ujPMjQhj<]rw#(jÖ)rx#}ry#(jAXtoplevel-functionsrz#jBjt#jCjDjEjÚjG}r{#(jI]jJ]jK]jL]jN]ujPMj<]r|#jZXtoplevel-functionsr}#…r~#}r#(jAjz#jBjx#ubaubjà)r€#}r#(jAUjG}r‚#(jI]jJ]jK]jL]jN]ujBjt#j<]rƒ#jq)r„#}r…#(jAX½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.r†#jBj€#jCjDjEjtjG}r‡#(jI]jJ]jK]jL]jN]ujPMj<]rˆ#jZX½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.r‰#…rŠ#}r‹#(jAj†#jBj„#ubaubajEjöubeubjÐ)rŒ#}r#(jAXÎ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. jBj#jCjDjEjÓjG}rŽ#(jI]jJ]jK]jL]jN]ujPM jQhj<]r#(jÖ)r#}r‘#(jAX all-functionsr’#jBjŒ#jCjDjEjÚjG}r“#(jI]jJ]jK]jL]jN]ujPM j<]r”#jZX all-functionsr•#…r–#}r—#(jAj’#jBj#ubaubjà)r˜#}r™#(jAUjG}rš#(jI]jJ]jK]jL]jN]ujBjŒ#j<]r›#jq)rœ#}r#(jAX¿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.rž#jBj˜#jCjDjEjtjG}rŸ#(jI]jJ]jK]jL]jN]ujPMj<]r #jZX¿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.r¡#…r¢#}r£#(jAjž#jBjœ#ubaubajEjöubeubeubjq)r¤#}r¥#(jAXUThis flag is new in Cabal-1.24. Prior versions used the equivalent of ``none`` above.jBjè"jCjDjEjtjG}r¦#(jI]jJ]jK]jL]jN]ujPM"jQhj<]r§#(jZXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of r¨#…r©#}rª#(jAXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of jCNjPNjQhjBj¤#ubjz)r«#}r¬#(jAX``none``jG}r­#(jI]jJ]jK]jL]jN]ujBj¤#j<]r®#jZXnoner¯#…r°#}r±#(jAUjBj«#ubajEj‚ubjZX above.r²#…r³#}r´#(jAX above.jCNjPNjQhjBj¤#ubeubeubeubjŠ)rµ#}r¶#(jAUjBjgjCjDjEjjG}r·#(jL]jK]jI]jJ]jN]Uentries]r¸#(jXGsetup-configure command line option; --library-profiling-detail[=level]hìUNtr¹#aujPNjQhj<]ubj’)rº#}r»#(jAUjBjgjCjDjEj•jG}r¼#(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr½#j›j½#ujPNjQhj<]r¾#(j)r¿#}rÀ#(jAX"--library-profiling-detail[=level]jBjº#jCjDjEj jG}rÁ#(j¢]rÂ#X--library-profiling-detail[rÃ#ajL]rÄ#hìajK]jI]jJ]jN]rÅ#hJaj¨‰ujPM.jQhj<]rÆ#(jª)rÇ#}rÈ#(jAjÃ#jBj¿#jCjDjEj­jG}rÉ#(jµj¶jL]jK]jI]jJ]jN]ujPM.jQhj<]rÊ#jZX--library-profiling-detail[rË#…rÌ#}rÍ#(jAUjCNjPNjQhjBjÇ#ubaubj³)rÎ#}rÏ#(jAX=level]jBj¿#jCjDjEj¶jG}rÐ#(jµj¶jL]jK]jI]jJ]jN]ujPM.jQhj<]rÑ#jZX=level]rÒ#…rÓ#}rÔ#(jAUjCNjPNjQhjBjÎ#ubaubeubjÎ)rÕ#}rÖ#(jAUjBjº#jCjDjEjÑjG}r×#(jI]jJ]jK]jL]jN]ujPM.jQhj<]rØ#(jq)rÙ#}rÚ#(jAXNAs with :option:`--profiling-detail` above, but it applies only for libraries.jBjÕ#jCjDjEjtjG}rÛ#(jI]jJ]jK]jL]jN]ujPM'jQhj<]rÜ#(jZXAs with rÝ#…rÞ#}rß#(jAXAs with jCNjPNjQhjBjÙ#ubj¥)rà#}rá#(jAX:option:`--profiling-detail`râ#jBjÙ#jCjDjEj©jG}rã#(UreftypeXoptionj«ˆj¬X--profiling-detailU refdomainXstdrä#jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM'j<]rå#jz)ræ#}rç#(jAjâ#jG}rè#(jI]jJ]ré#(j¶jä#X std-optionrê#ejK]jL]jN]ujBjà#j<]rë#jZX--profiling-detailrì#…rí#}rî#(jAUjBjæ#ubajEj‚ubaubjZX* above, but it applies only for libraries.rï#…rð#}rñ#(jAX* above, but it applies only for libraries.jCNjPNjQhjBjÙ#ubeubjq)rò#}ró#(jAXÙThe level for both libraries and executables is set by the :option:`--profiling-detail` flag, but if different levels are desired for libraries versus executables then use :option:`--library-profiling-detail` as well.jBjÕ#jCjDjEjtjG}rô#(jI]jJ]jK]jL]jN]ujPM*jQhj<]rõ#(jZX;The level for both libraries and executables is set by the rö#…r÷#}rø#(jAX;The level for both libraries and executables is set by the jCNjPNjQhjBjò#ubj¥)rù#}rú#(jAX:option:`--profiling-detail`rû#jBjò#jCjDjEj©jG}rü#(UreftypeXoptionj«ˆj¬X--profiling-detailU refdomainXstdrý#jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM*j<]rþ#jz)rÿ#}r$(jAjû#jG}r$(jI]jJ]r$(j¶jý#X std-optionr$ejK]jL]jN]ujBjù#j<]r$jZX--profiling-detailr$…r$}r$(jAUjBjÿ#ubajEj‚ubaubjZXU flag, but if different levels are desired for libraries versus executables then use r$…r $}r $(jAXU flag, but if different levels are desired for libraries versus executables then use jCNjPNjQhjBjò#ubj¥)r $}r $(jAX$:option:`--library-profiling-detail`r $jBjò#jCjDjEj©jG}r$(UreftypeXoptionj«ˆj¬X--library-profiling-detailU refdomainXstdr$jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM*j<]r$jz)r$}r$(jAj $jG}r$(jI]jJ]r$(j¶j$X std-optionr$ejK]jL]jN]ujBj $j<]r$jZX--library-profiling-detailr$…r$}r$(jAUjBj$ubajEj‚ubaubjZX as well.r$…r$}r$(jAX as well.jCNjPNjQhjBjò#ubeubeubeubjŠ)r$}r$(jAUjBjgjCjDjEjjG}r$(jL]jK]jI]jJ]jN]Uentries]r $(jX=setup-configure command line option; --enable-library-vanillajUNtr!$aujPNjQhj<]ubj’)r"$}r#$(jAUjBjgjCjDjEj•jG}r$$(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr%$j›j%$ujPNjQhj<]r&$(j)r'$}r($(jAX--enable-library-vanillar)$jBj"$jCjDjEj jG}r*$(j¢]r+$j)$ajL]r,$jajK]jI]jJ]jN]r-$hdaj¨‰ujPM5jQhj<]r.$(jª)r/$}r0$(jAj)$jBj'$jCjDjEj­jG}r1$(jµj¶jL]jK]jI]jJ]jN]ujPM5jQhj<]r2$jZX--enable-library-vanillar3$…r4$}r5$(jAUjCNjPNjQhjBj/$ubaubj³)r6$}r7$(jAUjBj'$jCjDjEj¶jG}r8$(jµj¶jL]jK]jI]jJ]jN]ujPM5jQhj<]ubeubjÎ)r9$}r:$(jAUjBj"$jCjDjEjÑjG}r;$(jI]jJ]jK]jL]jN]ujPM5jQhj<]r<$jq)r=$}r>$(jAX±(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the :option:`--enable-library-profiling` option. If you enable both, you get both.jBj9$jCjDjEjtjG}r?$(jI]jJ]jK]jL]jN]ujPM1jQhj<]r@$(jZXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the rA$…rB$}rC$(jAXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the jCNjPNjQhjBj=$ubj¥)rD$}rE$(jAX$:option:`--enable-library-profiling`rF$jBj=$jCjDjEj©jG}rG$(UreftypeXoptionj«ˆj¬X--enable-library-profilingU refdomainXstdrH$jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM1j<]rI$jz)rJ$}rK$(jAjF$jG}rL$(jI]jJ]rM$(j¶jH$X std-optionrN$ejK]jL]jN]ujBjD$j<]rO$jZX--enable-library-profilingrP$…rQ$}rR$(jAUjBjJ$ubajEj‚ubaubjZX* option. If you enable both, you get both.rS$…rT$}rU$(jAX* option. If you enable both, you get both.jCNjPNjQhjBj=$ubeubaubeubjŠ)rV$}rW$(jAUjBjgjCjDjEjjG}rX$(jL]jK]jI]jJ]jN]Uentries]rY$(jX>setup-configure command line option; --disable-library-vanillah·UNtrZ$aujPNjQhj<]ubj’)r[$}r\$(jAUjBjgjCjDjEj•jG}r]$(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr^$j›j^$ujPNjQhj<]r_$(j)r`$}ra$(jAX--disable-library-vanillarb$jBj[$jCjDjEj jG}rc$(j¢]rd$jb$ajL]re$h·ajK]jI]jJ]jN]rf$haj¨‰ujPM;jQhj<]rg$(jª)rh$}ri$(jAjb$jBj`$jCjDjEj­jG}rj$(jµj¶jL]jK]jI]jJ]jN]ujPM;jQhj<]rk$jZX--disable-library-vanillarl$…rm$}rn$(jAUjCNjPNjQhjBjh$ubaubj³)ro$}rp$(jAUjBj`$jCjDjEj¶jG}rq$(jµj¶jL]jK]jI]jJ]jN]ujPM;jQhj<]ubeubjÎ)rr$}rs$(jAUjBj[$jCjDjEjÑjG}rt$(jI]jJ]jK]jL]jN]ujPM;jQhj<]ru$jq)rv$}rw$(jAX¹Do not build ordinary libraries. This is useful in conjunction with :option:`--enable-library-profiling` to build only profiling libraries, rather than profiling and ordinary libraries.jBjr$jCjDjEjtjG}rx$(jI]jJ]jK]jL]jN]ujPM8jQhj<]ry$(jZXDDo not build ordinary libraries. This is useful in conjunction with rz$…r{$}r|$(jAXDDo not build ordinary libraries. This is useful in conjunction with jCNjPNjQhjBjv$ubj¥)r}$}r~$(jAX$:option:`--enable-library-profiling`r$jBjv$jCjDjEj©jG}r€$(UreftypeXoptionj«ˆj¬X--enable-library-profilingU refdomainXstdr$jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM8j<]r‚$jz)rƒ$}r„$(jAj$jG}r…$(jI]jJ]r†$(j¶j$X std-optionr‡$ejK]jL]jN]ujBj}$j<]rˆ$jZX--enable-library-profilingr‰$…rŠ$}r‹$(jAUjBjƒ$ubajEj‚ubaubjZXQ to build only profiling libraries, rather than profiling and ordinary libraries.rŒ$…r$}rŽ$(jAXQ to build only profiling libraries, rather than profiling and ordinary libraries.jCNjPNjQhjBjv$ubeubaubeubjŠ)r$}r$(jAUjBjgjCjDjEjjG}r‘$(jL]jK]jI]jJ]jN]Uentries]r’$(jX>setup-configure command line option; --enable-library-for-ghcihªUNtr“$aujPNjQhj<]ubj’)r”$}r•$(jAUjBjgjCjDjEj•jG}r–$(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr—$j›j—$ujPNjQhj<]r˜$(j)r™$}rš$(jAX--enable-library-for-ghcir›$jBj”$jCjDjEj jG}rœ$(j¢]r$j›$ajL]rž$hªajK]jI]jJ]jN]rŸ$haj¨‰ujPM?jQhj<]r $(jª)r¡$}r¢$(jAj›$jBj™$jCjDjEj­jG}r£$(jµj¶jL]jK]jI]jJ]jN]ujPM?jQhj<]r¤$jZX--enable-library-for-ghcir¥$…r¦$}r§$(jAUjCNjPNjQhjBj¡$ubaubj³)r¨$}r©$(jAUjBj™$jCjDjEj¶jG}rª$(jµj¶jL]jK]jI]jJ]jN]ujPM?jQhj<]ubeubjÎ)r«$}r¬$(jAUjBj”$jCjDjEjÑjG}r­$(jI]jJ]jK]jL]jN]ujPM?jQhj<]r®$jq)r¯$}r°$(jAX5(default) Build libraries suitable for use with GHCi.r±$jBj«$jCjDjEjtjG}r²$(jI]jJ]jK]jL]jN]ujPM>jQhj<]r³$jZX5(default) Build libraries suitable for use with GHCi.r´$…rµ$}r¶$(jAj±$jCNjPNjQhjBj¯$ubaubaubeubjŠ)r·$}r¸$(jAUjBjgjCjDjEjjG}r¹$(jL]jK]jI]jJ]jN]Uentries]rº$(jX?setup-configure command line option; --disable-library-for-ghcih½UNtr»$aujPNjQhj<]ubj’)r¼$}r½$(jAUjBjgjCjDjEj•jG}r¾$(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¿$j›j¿$ujPNjQhj<]rÀ$(j)rÁ$}rÂ$(jAX--disable-library-for-ghcirÃ$jBj¼$jCjDjEj jG}rÄ$(j¢]rÅ$jÃ$ajL]rÆ$h½ajK]jI]jJ]jN]rÇ$haj¨‰ujPMEjQhj<]rÈ$(jª)rÉ$}rÊ$(jAjÃ$jBjÁ$jCjDjEj­jG}rË$(jµj¶jL]jK]jI]jJ]jN]ujPMEjQhj<]rÌ$jZX--disable-library-for-ghcirÍ$…rÎ$}rÏ$(jAUjCNjPNjQhjBjÉ$ubaubj³)rÐ$}rÑ$(jAUjBjÁ$jCjDjEj¶jG}rÒ$(jµj¶jL]jK]jI]jJ]jN]ujPMEjQhj<]ubeubjÎ)rÓ$}rÔ$(jAUjBj¼$jCjDjEjÑjG}rÕ$(jI]jJ]jK]jL]jN]ujPMEjQhj<]rÖ$jq)r×$}rØ$(jAX’Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases this flag can be used as a workaround.rÙ$jBjÓ$jCjDjEjtjG}rÚ$(jI]jJ]jK]jL]jN]ujPMBjQhj<]rÛ$jZX’Not all platforms support GHCi and indeed on some platforms, trying to build GHCi libs fails. In such cases this flag can be used as a workaround.rÜ$…rÝ$}rÞ$(jAjÙ$jCNjPNjQhjBj×$ubaubaubeubjŠ)rß$}rà$(jAUjBjgjCjDjEjjG}rá$(jL]jK]jI]jJ]jN]Uentries]râ$(jX8setup-configure command line option; --enable-split-objshÁUNtrã$aujPNjQhj<]ubj’)rä$}rå$(jAUjBjgjCjDjEj•jG}ræ$(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrç$j›jç$ujPNjQhj<]rè$(j)ré$}rê$(jAX--enable-split-objsrë$jBjä$jCjDjEj jG}rì$(j¢]rí$jë$ajL]rî$hÁajK]jI]jJ]jN]rï$haj¨‰ujPMMjQhj<]rð$(jª)rñ$}rò$(jAjë$jBjé$jCjDjEj­jG}ró$(jµj¶jL]jK]jI]jJ]jN]ujPMMjQhj<]rô$jZX--enable-split-objsrõ$…rö$}r÷$(jAUjCNjPNjQhjBjñ$ubaubj³)rø$}rù$(jAUjBjé$jCjDjEj¶jG}rú$(jµj¶jL]jK]jI]jJ]jN]ujPMMjQhj<]ubeubjÎ)rû$}rü$(jAUjBjä$jCjDjEjÑjG}rý$(jI]jJ]jK]jL]jN]ujPMMjQhj<]rþ$jq)rÿ$}r%(jAX6Use 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.jBjû$jCjDjEjtjG}r%(jI]jJ]jK]jL]jN]ujPMHjQhj<]r%(jZX Use the GHC r%…r%}r%(jAX Use the GHC jCNjPNjQhjBjÿ$ubjz)r%}r%(jAX``-split-objs``jG}r%(jI]jJ]jK]jL]jN]ujBjÿ$j<]r %jZX -split-objsr %…r %}r %(jAUjBj%ubajEj‚ubjZX 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%(jAX 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.jCNjPNjQhjBjÿ$ubeubaubeubjŠ)r%}r%(jAUjBjgjCjDjEjjG}r%(jL]jK]jI]jJ]jN]Uentries]r%(jX9setup-configure command line option; --disable-split-objsj4UNtr%aujPNjQhj<]ubj’)r%}r%(jAUjBjgjCjDjEj•jG}r%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr%j›j%ujPNjQhj<]r%(j)r%}r%(jAX--disable-split-objsr%jBj%jCjDjEj jG}r%(j¢]r%j%ajL]r%j4ajK]jI]jJ]jN]r %h˜aj¨‰ujPMSjQhj<]r!%(jª)r"%}r#%(jAj%jBj%jCjDjEj­jG}r$%(jµj¶jL]jK]jI]jJ]jN]ujPMSjQhj<]r%%jZX--disable-split-objsr&%…r'%}r(%(jAUjCNjPNjQhjBj"%ubaubj³)r)%}r*%(jAUjBj%jCjDjEj¶jG}r+%(jµj¶jL]jK]jI]jJ]jN]ujPMSjQhj<]ubeubjÎ)r,%}r-%(jAUjBj%jCjDjEjÑjG}r.%(jI]jJ]jK]jL]jN]ujPMSjQhj<]r/%jq)r0%}r1%(jAXœ(default) Do not use the GHC ``-split-objs`` feature. This makes building the library quicker but the final executables that use the library will be larger.jBj,%jCjDjEjtjG}r2%(jI]jJ]jK]jL]jN]ujPMPjQhj<]r3%(jZX(default) Do not use the GHC r4%…r5%}r6%(jAX(default) Do not use the GHC jCNjPNjQhjBj0%ubjz)r7%}r8%(jAX``-split-objs``jG}r9%(jI]jJ]jK]jL]jN]ujBj0%j<]r:%jZX -split-objsr;%…r<%}r=%(jAUjBj7%ubajEj‚ubjZXp feature. This makes building the library quicker but the final executables that use the library will be larger.r>%…r?%}r@%(jAXp feature. This makes building the library quicker but the final executables that use the library will be larger.jCNjPNjQhjBj0%ubeubaubeubjŠ)rA%}rB%(jAUjBjgjCjDjEjjG}rC%(jL]jK]jI]jJ]jN]Uentries]rD%(jXBsetup-configure command line option; --enable-executable-strippinghòUNtrE%aujPNjQhj<]ubj’)rF%}rG%(jAUjBjgjCjDjEj•jG}rH%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrI%j›jI%ujPNjQhj<]rJ%(j)rK%}rL%(jAX--enable-executable-strippingrM%jBjF%jCjDjEj jG}rN%(j¢]rO%jM%ajL]rP%hòajK]jI]jJ]jN]rQ%hPaj¨‰ujPM_jQhj<]rR%(jª)rS%}rT%(jAjM%jBjK%jCjDjEj­jG}rU%(jµj¶jL]jK]jI]jJ]jN]ujPM_jQhj<]rV%jZX--enable-executable-strippingrW%…rX%}rY%(jAUjCNjPNjQhjBjS%ubaubj³)rZ%}r[%(jAUjBjK%jCjDjEj¶jG}r\%(jµj¶jL]jK]jI]jJ]jN]ujPM_jQhj<]ubeubjÎ)r]%}r^%(jAUjBjF%jCjDjEjÑjG}r_%(jI]jJ]jK]jL]jN]ujPM_jQhj<]r`%(jq)ra%}rb%(jAX…(default) 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. While such extra information is useful for debugging C programs with traditional debuggers it is rarely helpful for debugging binaries produced by Haskell compilers.jBj]%jCjDjEjtjG}rc%(jI]jJ]jK]jL]jN]ujPMVjQhj<]rd%(jZX>(default) When installing binary executable programs, run the re%…rf%}rg%(jAX>(default) When installing binary executable programs, run the jCNjPNjQhjBja%ubjz)rh%}ri%(jAX ``strip``jG}rj%(jI]jJ]jK]jL]jN]ujBja%j<]rk%jZXstriprl%…rm%}rn%(jAUjBjh%ubajEj‚ubjZX> program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols. While such extra information is useful for debugging C programs with traditional debuggers it is rarely helpful for debugging binaries produced by Haskell compilers.ro%…rp%}rq%(jAX> program on the binary. This can considerably reduce the size of the executable binary file. It does this by removing debugging information and symbols. While such extra information is useful for debugging C programs with traditional debuggers it is rarely helpful for debugging binaries produced by Haskell compilers.jCNjPNjQhjBja%ubeubjq)rr%}rs%(jAXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.rt%jBj]%jCjDjEjtjG}ru%(jI]jJ]jK]jL]jN]ujPM]jQhj<]rv%jZXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.rw%…rx%}ry%(jAjt%jCNjPNjQhjBjr%ubaubeubeubjŠ)rz%}r{%(jAUjBjgjCjDjEjjG}r|%(jL]jK]jI]jJ]jN]Uentries]r}%(jXCsetup-configure command line option; --disable-executable-strippingj*UNtr~%aujPNjQhj<]ubj’)r%}r€%(jAUjBjgjCjDjEj•jG}r%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr‚%j›j‚%ujPNjQhj<]rƒ%(j)r„%}r…%(jAX--disable-executable-strippingr†%jBj%jCjDjEj jG}r‡%(j¢]rˆ%j†%ajL]r‰%j*ajK]jI]jJ]jN]rŠ%hŽaj¨‰ujPMhjQhj<]r‹%(jª)rŒ%}r%(jAj†%jBj„%jCjDjEj­jG}rŽ%(jµj¶jL]jK]jI]jJ]jN]ujPMhjQhj<]r%jZX--disable-executable-strippingr%…r‘%}r’%(jAUjCNjPNjQhjBjŒ%ubaubj³)r“%}r”%(jAUjBj„%jCjDjEj¶jG}r•%(jµj¶jL]jK]jI]jJ]jN]ujPMhjQhj<]ubeubjÎ)r–%}r—%(jAUjBj%jCjDjEjÑjG}r˜%(jI]jJ]jK]jL]jN]ujPMhjQhj<]r™%jq)rš%}r›%(jAXtDo not strip binary executables during installation. You might want to use this option if you need to debug a program using gdb, for example if you want to debug the C parts of a program containing both Haskell and C code. Another reason is if your are building a package for a system which has a policy of managing the stripping itself (such as some Linux distributions).rœ%jBj–%jCjDjEjtjG}r%(jI]jJ]jK]jL]jN]ujPMbjQhj<]rž%jZXtDo not strip binary executables during installation. You might want to use this option if you need to debug a program using gdb, for example if you want to debug the C parts of a program containing both Haskell and C code. Another reason is if your are building a package for a system which has a policy of managing the stripping itself (such as some Linux distributions).rŸ%…r %}r¡%(jAjœ%jCNjPNjQhjBjš%ubaubaubeubjŠ)r¢%}r£%(jAUjBjgjCjDjEjjG}r¤%(jL]jK]jI]jJ]jN]Uentries]r¥%(jX4setup-configure command line option; --enable-sharedj"UNtr¦%aujPNjQhj<]ubj’)r§%}r¨%(jAUjBjgjCjDjEj•jG}r©%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrª%j›jª%ujPNjQhj<]r«%(j)r¬%}r­%(jAX--enable-sharedr®%jBj§%jCjDjEj jG}r¯%(j¢]r°%j®%ajL]r±%j"ajK]jI]jJ]jN]r²%h…aj¨‰ujPMmjQhj<]r³%(jª)r´%}rµ%(jAj®%jBj¬%jCjDjEj­jG}r¶%(jµj¶jL]jK]jI]jJ]jN]ujPMmjQhj<]r·%jZX--enable-sharedr¸%…r¹%}rº%(jAUjCNjPNjQhjBj´%ubaubj³)r»%}r¼%(jAUjBj¬%jCjDjEj¶jG}r½%(jµj¶jL]jK]jI]jJ]jN]ujPMmjQhj<]ubeubjÎ)r¾%}r¿%(jAUjBj§%jCjDjEjÑjG}rÀ%(jI]jJ]jK]jL]jN]ujPMmjQhj<]rÁ%jq)rÂ%}rÃ%(jAXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rÄ%jBj¾%jCjDjEjtjG}rÅ%(jI]jJ]jK]jL]jN]ujPMkjQhj<]rÆ%jZXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rÇ%…rÈ%}rÉ%(jAjÄ%jCNjPNjQhjBjÂ%ubaubaubeubjŠ)rÊ%}rË%(jAUjBjgjCjDjEjjG}rÌ%(jL]jK]jI]jJ]jN]Uentries]rÍ%(jX5setup-configure command line option; --disable-sharedhçUNtrÎ%aujPNjQhj<]ubj’)rÏ%}rÐ%(jAUjBjgjCjDjEj•jG}rÑ%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÒ%j›jÒ%ujPNjQhj<]rÓ%(j)rÔ%}rÕ%(jAX--disable-sharedrÖ%jBjÏ%jCjDjEj jG}r×%(j¢]rØ%jÖ%ajL]rÙ%hçajK]jI]jJ]jN]rÚ%hEaj¨‰ujPMqjQhj<]rÛ%(jª)rÜ%}rÝ%(jAjÖ%jBjÔ%jCjDjEj­jG}rÞ%(jµj¶jL]jK]jI]jJ]jN]ujPMqjQhj<]rß%jZX--disable-sharedrà%…rá%}râ%(jAUjCNjPNjQhjBjÜ%ubaubj³)rã%}rä%(jAUjBjÔ%jCjDjEj¶jG}rå%(jµj¶jL]jK]jI]jJ]jN]ujPMqjQhj<]ubeubjÎ)ræ%}rç%(jAUjBjÏ%jCjDjEjÑjG}rè%(jI]jJ]jK]jL]jN]ujPMqjQhj<]ré%jq)rê%}rë%(jAX&(default) Do not build shared library.rì%jBjæ%jCjDjEjtjG}rí%(jI]jJ]jK]jL]jN]ujPMpjQhj<]rî%jZX&(default) Do not build shared library.rï%…rð%}rñ%(jAjì%jCNjPNjQhjBjê%ubaubaubeubjŠ)rò%}ró%(jAUjBjgjCjDjEjjG}rô%(jL]jK]jI]jJ]jN]Uentries]rõ%(jX@setup-configure command line option; --enable-executable-dynamicjUNtrö%aujPNjQhj<]ubj’)r÷%}rø%(jAUjBjgjCjDjEj•jG}rù%(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrú%j›jú%ujPNjQhj<]rû%(j)rü%}rý%(jAX--enable-executable-dynamicrþ%jBj÷%jCjDjEj jG}rÿ%(j¢]r&jþ%ajL]r&jajK]jI]jJ]jN]r&h{aj¨‰ujPMwjQhj<]r&(jª)r&}r&(jAjþ%jBjü%jCjDjEj­jG}r&(jµj¶jL]jK]jI]jJ]jN]ujPMwjQhj<]r&jZX--enable-executable-dynamicr&…r &}r &(jAUjCNjPNjQhjBj&ubaubj³)r &}r &(jAUjBjü%jCjDjEj¶jG}r &(jµj¶jL]jK]jI]jJ]jN]ujPMwjQhj<]ubeubjÎ)r&}r&(jAUjBj÷%jCjDjEjÑjG}r&(jI]jJ]jK]jL]jN]ujPMwjQhj<]r&jq)r&}r&(jAXÈLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies :option:`--enable-shared` unless :option:`--disable-shared` is explicitly specified.jBj&jCjDjEjtjG}r&(jI]jJ]jK]jL]jN]ujPMtjQhj<]r&(jZXvLink executables dynamically. The executable’s library dependencies should be built as shared objects. This implies r&…r&}r&(jAXtLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies jCNjPNjQhjBj&ubj¥)r&}r&(jAX:option:`--enable-shared`r&jBj&jCjDjEj©jG}r&(UreftypeXoptionj«ˆj¬X--enable-sharedU refdomainXstdr&jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMtj<]r&jz)r&}r &(jAj&jG}r!&(jI]jJ]r"&(j¶j&X std-optionr#&ejK]jL]jN]ujBj&j<]r$&jZX--enable-sharedr%&…r&&}r'&(jAUjBj&ubajEj‚ubaubjZX unless r(&…r)&}r*&(jAX unless jCNjPNjQhjBj&ubj¥)r+&}r,&(jAX:option:`--disable-shared`r-&jBj&jCjDjEj©jG}r.&(UreftypeXoptionj«ˆj¬X--disable-sharedU refdomainXstdr/&jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMtj<]r0&jz)r1&}r2&(jAj-&jG}r3&(jI]jJ]r4&(j¶j/&X std-optionr5&ejK]jL]jN]ujBj+&j<]r6&jZX--disable-sharedr7&…r8&}r9&(jAUjBj1&ubajEj‚ubaubjZX is explicitly specified.r:&…r;&}r<&(jAX is explicitly specified.jCNjPNjQhjBj&ubeubaubeubjŠ)r=&}r>&(jAUjBjgjCjDjEjjG}r?&(jL]jK]jI]jJ]jN]Uentries]r@&(jXAsetup-configure command line option; --disable-executable-dynamichöUNtrA&aujPNjQhj<]ubj’)rB&}rC&(jAUjBjgjCjDjEj•jG}rD&(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrE&j›jE&ujPNjQhj<]rF&(j)rG&}rH&(jAX--disable-executable-dynamicrI&jBjB&jCjDjEj jG}rJ&(j¢]rK&jI&ajL]rL&höajK]jI]jJ]jN]rM&hTaj¨‰ujPM{jQhj<]rN&(jª)rO&}rP&(jAjI&jBjG&jCjDjEj­jG}rQ&(jµj¶jL]jK]jI]jJ]jN]ujPM{jQhj<]rR&jZX--disable-executable-dynamicrS&…rT&}rU&(jAUjCNjPNjQhjBjO&ubaubj³)rV&}rW&(jAUjBjG&jCjDjEj¶jG}rX&(jµj¶jL]jK]jI]jJ]jN]ujPM{jQhj<]ubeubjÎ)rY&}rZ&(jAUjBjB&jCjDjEjÑjG}r[&(jI]jJ]jK]jL]jN]ujPM{jQhj<]r\&jq)r]&}r^&(jAX&(default) Link executables statically.r_&jBjY&jCjDjEjtjG}r`&(jI]jJ]jK]jL]jN]ujPMzjQhj<]ra&jZX&(default) Link executables statically.rb&…rc&}rd&(jAj_&jCNjPNjQhjBj]&ubaubaubeubjŠ)re&}rf&(jAUjBjgjCjDjEjjG}rg&(jL]jK]jI]jJ]jN]Uentries]rh&(jX;setup-configure command line option; --configure-option=strjUNtri&aujPNjQhj<]ubj’)rj&}rk&(jAUjBjgjCjDjEj•jG}rl&(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrm&j›jm&ujPNjQhj<]rn&(j)ro&}rp&(jAX--configure-option=strjBjj&jCjDjEj jG}rq&(j¢]rr&X--configure-optionrs&ajL]rt&jajK]jI]jJ]jN]ru&hcaj¨‰ujPM‚jQhj<]rv&(jª)rw&}rx&(jAjs&jBjo&jCjDjEj­jG}ry&(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]rz&jZX--configure-optionr{&…r|&}r}&(jAUjCNjPNjQhjBjw&ubaubj³)r~&}r&(jAX=strjBjo&jCjDjEj¶jG}r€&(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]r&jZX=strr‚&…rƒ&}r„&(jAUjCNjPNjQhjBj~&ubaubeubjÎ)r…&}r†&(jAUjBjj&jCjDjEjÑjG}r‡&(jI]jJ]jK]jL]jN]ujPM‚jQhj<]rˆ&jq)r‰&}rŠ&(jAX×An extra option to an external ``configure`` script, if one is used (see the section on `system-dependent parameters `__). There can be several of these options.jBj…&jCjDjEjtjG}r‹&(jI]jJ]jK]jL]jN]ujPM~jQhj<]rŒ&(jZXAn extra option to an external r&…rŽ&}r&(jAXAn extra option to an external jCNjPNjQhjBj‰&ubjz)r&}r‘&(jAX ``configure``jG}r’&(jI]jJ]jK]jL]jN]ujBj‰&j<]r“&jZX configurer”&…r•&}r–&(jAUjBj&ubajEj‚ubjZX, script, if one is used (see the section on r—&…r˜&}r™&(jAX, script, if one is used (see the section on jCNjPNjQhjBj‰&ubj”)rš&}r›&(jAXV`system-dependent parameters `__jG}rœ&(UnameXsystem-dependent parametersjâX4developing-packages.html#system-dependent-parametersjL]jK]jI]jJ]jN]ujBj‰&j<]r&jZXsystem-dependent parametersrž&…rŸ&}r &(jAUjBjš&ubajEjubjZX)). There can be several of these options.r¡&…r¢&}r£&(jAX)). There can be several of these options.jCNjPNjQhjBj‰&ubeubaubeubjŠ)r¤&}r¥&(jAUjBjgjCjDjEjjG}r¦&(jL]jK]jI]jJ]jN]Uentries]r§&(jX?setup-configure command line option; --extra-include-dirs[=dir]hôUNtr¨&aujPNjQhj<]ubj’)r©&}rª&(jAUjBjgjCjDjEj•jG}r«&(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¬&j›j¬&ujPNjQhj<]r­&(j)r®&}r¯&(jAX--extra-include-dirs[=dir]jBj©&jCjDjEj jG}r°&(j¢]r±&X--extra-include-dirs[r²&ajL]r³&hôajK]jI]jJ]jN]r´&hRaj¨‰ujPM‘jQhj<]rµ&(jª)r¶&}r·&(jAj²&jBj®&jCjDjEj­jG}r¸&(jµj¶jL]jK]jI]jJ]jN]ujPM‘jQhj<]r¹&jZX--extra-include-dirs[rº&…r»&}r¼&(jAUjCNjPNjQhjBj¶&ubaubj³)r½&}r¾&(jAX=dir]jBj®&jCjDjEj¶jG}r¿&(jµj¶jL]jK]jI]jJ]jN]ujPM‘jQhj<]rÀ&jZX=dir]rÁ&…rÂ&}rÃ&(jAUjCNjPNjQhjBj½&ubaubeubjÎ)rÄ&}rÅ&(jAUjBj©&jCjDjEjÑjG}rÆ&(jI]jJ]jK]jL]jN]ujPM‘jQhj<]rÇ&(jq)rÈ&}rÉ&(jAXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rÊ&jBjÄ&jCjDjEjtjG}rË&(jI]jJ]jK]jL]jN]ujPM…jQhj<]rÌ&jZXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rÍ&…rÎ&}rÏ&(jAjÊ&jCNjPNjQhjBjÈ&ubaubjq)rÐ&}rÑ&(jAXPYou 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 ``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.jBjÄ&jCjDjEjtjG}rÒ&(jI]jJ]jK]jL]jN]ujPMˆjQhj<]rÓ&(jZXYou 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Ö&(jAX‹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 jCNjPNjQhjBjÐ&ubjz)r×&}rØ&(jAX ``.cabal``jG}rÙ&(jI]jJ]jK]jL]jN]ujBjÐ&j<]rÚ&jZX.cabalrÛ&…rÜ&}rÝ&(jAUjBj×&ubajEj‚ubjZXH file. Using this option has the same affect as appending the directory rÞ&…rß&}rà&(jAXH file. Using this option has the same affect as appending the directory jCNjPNjQhjBjÐ&ubjµ)rá&}râ&(jAX*dir*jG}rã&(jI]jJ]jK]jL]jN]ujBjÐ&j<]rä&jZXdirrå&…ræ&}rç&(jAUjBjá&ubajEj½ubjZX to the rè&…ré&}rê&(jAX to the jCNjPNjQhjBjÐ&ubjz)rë&}rì&(jAX``include-dirs``jG}rí&(jI]jJ]jK]jL]jN]ujBjÐ&j<]rî&jZX include-dirsrï&…rð&}rñ&(jAUjBjë&ubajEj‚ubjZX9 field in each library and executable in the package’s rò&…ró&}rô&(jAX7 field in each library and executable in the package's jCNjPNjQhjBjÐ&ubjz)rõ&}rö&(jAX ``.cabal``jG}r÷&(jI]jJ]jK]jL]jN]ujBjÐ&j<]rø&jZX.cabalrù&…rú&}rû&(jAUjBjõ&ubajEj‚ubjZX 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þ&(jAX 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.jCNjPNjQhjBjÐ&ubeubeubeubjŠ)rÿ&}r'(jAUjBjgjCjDjEjjG}r'(jL]jK]jI]jJ]jN]Uentries]r'(jX;setup-configure command line option; --extra-lib-dirs[=dir]hÊUNtr'aujPNjQhj<]ubj’)r'}r'(jAUjBjgjCjDjEj•jG}r'(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr'j›j'ujPNjQhj<]r'(j)r '}r '(jAX--extra-lib-dirs[=dir]jBj'jCjDjEj jG}r '(j¢]r 'X--extra-lib-dirs[r 'ajL]r'hÊajK]jI]jJ]jN]r'h'aj¨‰ujPM–jQhj<]r'(jª)r'}r'(jAj 'jBj 'jCjDjEj­jG}r'(jµj¶jL]jK]jI]jJ]jN]ujPM–jQhj<]r'jZX--extra-lib-dirs[r'…r'}r'(jAUjCNjPNjQhjBj'ubaubj³)r'}r'(jAX=dir]jBj 'jCjDjEj¶jG}r'(jµj¶jL]jK]jI]jJ]jN]ujPM–jQhj<]r'jZX=dir]r'…r'}r'(jAUjCNjPNjQhjBj'ubaubeubjÎ)r'}r '(jAUjBj'jCjDjEjÑjG}r!'(jI]jJ]jK]jL]jN]ujPM–jQhj<]r"'jq)r#'}r$'(jAX{An extra directory to search for system libraries files. You can use this flag multiple times to get a list of directories.r%'jBj'jCjDjEjtjG}r&'(jI]jJ]jK]jL]jN]ujPM”jQhj<]r''jZX{An extra directory to search for system libraries files. You can use this flag multiple times to get a list of directories.r('…r)'}r*'(jAj%'jCNjPNjQhjBj#'ubaubaubeubjŠ)r+'}r,'(jAUjBjgjCjDjEjjG}r-'(jL]jK]jI]jJ]jN]Uentries]r.'(jXAsetup-configure command line option; --extra-framework-dirs[=dir]j6UNtr/'aujPNjQhj<]ubj’)r0'}r1'(jAUjBjgjCjDjEj•jG}r2'(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr3'j›j3'ujPNjQhj<]r4'(j)r5'}r6'(jAX--extra-framework-dirs[=dir]jBj0'jCjDjEj jG}r7'(j¢]r8'X--extra-framework-dirs[r9'ajL]r:'j6ajK]jI]jJ]jN]r;'hšaj¨‰ujPM¥jQhj<]r<'(jª)r='}r>'(jAj9'jBj5'jCjDjEj­jG}r?'(jµj¶jL]jK]jI]jJ]jN]ujPM¥jQhj<]r@'jZX--extra-framework-dirs[rA'…rB'}rC'(jAUjCNjPNjQhjBj='ubaubj³)rD'}rE'(jAX=dir]jBj5'jCjDjEj¶jG}rF'(jµj¶jL]jK]jI]jJ]jN]ujPM¥jQhj<]rG'jZX=dir]rH'…rI'}rJ'(jAUjCNjPNjQhjBjD'ubaubeubjÎ)rK'}rL'(jAUjBj0'jCjDjEjÑjG}rM'(jI]jJ]jK]jL]jN]ujPM¥jQhj<]rN'(jq)rO'}rP'(jAX{An extra directory to search for frameworks (OS X only). You can use this flag multiple times to get a list of directories.rQ'jBjK'jCjDjEjtjG}rR'(jI]jJ]jK]jL]jN]ujPM™jQhj<]rS'jZX{An extra directory to search for frameworks (OS X only). You can use this flag multiple times to get a list of directories.rT'…rU'}rV'(jAjQ'jCNjPNjQhjBjO'ubaubjq)rW'}rX'(jAXOYou 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 ``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.jBjK'jCjDjEjtjG}rY'(jI]jJ]jK]jL]jN]ujPMœjQhj<]rZ'(jZXŠ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]'(jAXˆ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 jCNjPNjQhjBjW'ubjz)r^'}r_'(jAX ``.cabal``jG}r`'(jI]jJ]jK]jL]jN]ujBjW'j<]ra'jZX.cabalrb'…rc'}rd'(jAUjBj^'ubajEj‚ubjZXH file. Using this option has the same affect as appending the directory re'…rf'}rg'(jAXH file. Using this option has the same affect as appending the directory jCNjPNjQhjBjW'ubjµ)rh'}ri'(jAX*dir*jG}rj'(jI]jJ]jK]jL]jN]ujBjW'j<]rk'jZXdirrl'…rm'}rn'(jAUjBjh'ubajEj½ubjZX to the ro'…rp'}rq'(jAX to the jCNjPNjQhjBjW'ubjz)rr'}rs'(jAX``extra-lib-dirs``jG}rt'(jI]jJ]jK]jL]jN]ujBjW'j<]ru'jZXextra-lib-dirsrv'…rw'}rx'(jAUjBjr'ubajEj‚ubjZX9 field in each library and executable in the package’s ry'…rz'}r{'(jAX7 field in each library and executable in the package's jCNjPNjQhjBjW'ubjz)r|'}r}'(jAX ``.cabal``jG}r~'(jI]jJ]jK]jL]jN]ujBjW'j<]r'jZX.cabalr€'…r'}r‚'(jAUjBj|'ubajEj‚ubjZX 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…'(jAX 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.jCNjPNjQhjBjW'ubeubeubeubjŠ)r†'}r‡'(jAUjBjgjCjDjEjjG}rˆ'(jL]jK]jI]jJ]jN]Uentries]r‰'(jX@setup-configure command line option; --dependency[=pkgname=ipid]hÏUNtrŠ'aujPNjQhj<]ubj’)r‹'}rŒ'(jAUjBjgjCjDjEj•jG}r'(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrŽ'j›jŽ'ujPNjQhj<]r'(j)r'}r‘'(jAX--dependency[=pkgname=ipid]jBj‹'jCjDjEj jG}r’'(j¢]r“'X --dependency[r”'ajL]r•'hÏajK]jI]jJ]jN]r–'h,aj¨‰ujPM«jQhj<]r—'(jª)r˜'}r™'(jAj”'jBj'jCjDjEj­jG}rš'(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]r›'jZX --dependency[rœ'…r'}rž'(jAUjCNjPNjQhjBj˜'ubaubj³)rŸ'}r '(jAX=pkgname=ipid]jBj'jCjDjEj¶jG}r¡'(jµj¶jL]jK]jI]jJ]jN]ujPM«jQhj<]r¢'jZX=pkgname=ipid]r£'…r¤'}r¥'(jAUjCNjPNjQhjBjŸ'ubaubeubjÎ)r¦'}r§'(jAUjBj‹'jCjDjEjÑjG}r¨'(jI]jJ]jK]jL]jN]ujPM«jQhj<]r©'jq)rª'}r«'(jAX¿Specify that a particular dependency should used for a particular package name. In particular, it declares that any reference to *pkgname* in a ``build-depends`` should be resolved to *ipid*.jBj¦'jCjDjEjtjG}r¬'(jI]jJ]jK]jL]jN]ujPM¨jQhj<]r­'(jZXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to r®'…r¯'}r°'(jAXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to jCNjPNjQhjBjª'ubjµ)r±'}r²'(jAX *pkgname*jG}r³'(jI]jJ]jK]jL]jN]ujBjª'j<]r´'jZXpkgnamerµ'…r¶'}r·'(jAUjBj±'ubajEj½ubjZX in a r¸'…r¹'}rº'(jAX in a jCNjPNjQhjBjª'ubjz)r»'}r¼'(jAX``build-depends``jG}r½'(jI]jJ]jK]jL]jN]ujBjª'j<]r¾'jZX build-dependsr¿'…rÀ'}rÁ'(jAUjBj»'ubajEj‚ubjZX should be resolved to rÂ'…rÃ'}rÄ'(jAX should be resolved to jCNjPNjQhjBjª'ubjµ)rÅ'}rÆ'(jAX*ipid*jG}rÇ'(jI]jJ]jK]jL]jN]ujBjª'j<]rÈ'jZXipidrÉ'…rÊ'}rË'(jAUjBjÅ'ubajEj½ubjZX.…rÌ'}rÍ'(jAX.jCNjPNjQhjBjª'ubeubaubeubjŠ)rÎ'}rÏ'(jAUjBjgjCjDjEjjG}rÐ'(jL]jK]jI]jJ]jN]Uentries]rÑ'(jX:setup-configure command line option; --exact-configurationj'UNtrÒ'aujPNjQhj<]ubj’)rÓ'}rÔ'(jAUjBjgjCjDjEj•jG}rÕ'(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÖ'j›jÖ'ujPNjQhj<]r×'(j)rØ'}rÙ'(jAX--exact-configurationrÚ'jBjÓ'jCjDjEj jG}rÛ'(j¢]rÜ'jÚ'ajL]rÝ'j'ajK]jI]jJ]jN]rÞ'hŠaj¨‰ujPM³jQhj<]rß'(jª)rà'}rá'(jAjÚ'jBjØ'jCjDjEj­jG}râ'(jµj¶jL]jK]jI]jJ]jN]ujPM³jQhj<]rã'jZX--exact-configurationrä'…rå'}ræ'(jAUjCNjPNjQhjBjà'ubaubj³)rç'}rè'(jAUjBjØ'jCjDjEj¶jG}ré'(jµj¶jL]jK]jI]jJ]jN]ujPM³jQhj<]ubeubjÎ)rê'}rë'(jAUjBjÓ'jCjDjEjÑjG}rì'(jI]jJ]jK]jL]jN]ujPM³jQhj<]rí'jq)rî'}rï'(jAX$This changes Cabal to require every dependency be explicitly specified using :option:`--dependency`, rather than use Cabal's (very simple) dependency solver. This is useful for programmatic use of Cabal's API, where you want to error if you didn't specify enough :option:`--dependency` flags.jBjê'jCjDjEjtjG}rð'(jI]jJ]jK]jL]jN]ujPM®jQhj<]rñ'(jZXMThis changes Cabal to require every dependency be explicitly specified using rò'…ró'}rô'(jAXMThis changes Cabal to require every dependency be explicitly specified using jCNjPNjQhjBjî'ubj¥)rõ'}rö'(jAX:option:`--dependency`r÷'jBjî'jCjDjEj©jG}rø'(UreftypeXoptionj«ˆj¬X --dependencyU refdomainXstdrù'jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM®j<]rú'jz)rû'}rü'(jAj÷'jG}rý'(jI]jJ]rþ'(j¶jù'X std-optionrÿ'ejK]jL]jN]ujBjõ'j<]r(jZX --dependencyr(…r(}r((jAUjBjû'ubajEj‚ubaubjZXª, rather than use Cabal’s (very simple) dependency solver. This is useful for programmatic use of Cabal’s API, where you want to error if you didn’t specify enough r(…r(}r((jAX¤, rather than use Cabal's (very simple) dependency solver. This is useful for programmatic use of Cabal's API, where you want to error if you didn't specify enough jCNjPNjQhjBjî'ubj¥)r(}r((jAX:option:`--dependency`r (jBjî'jCjDjEj©jG}r ((UreftypeXoptionj«ˆj¬X --dependencyU refdomainXstdr (jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM®j<]r (jz)r (}r((jAj (jG}r((jI]jJ]r((j¶j (X std-optionr(ejK]jL]jN]ujBj(j<]r(jZX --dependencyr(…r(}r((jAUjBj (ubajEj‚ubaubjZX flags.r(…r(}r((jAX flags.jCNjPNjQhjBjî'ubeubaubeubjŠ)r(}r((jAUjBjgjCjDjEjjG}r((jL]jK]jI]jJ]jN]Uentries]r((jXOsetup-configure command line option; --allow-newer[=pkgs], --allow-older[=pkgs]hÚUNtr(aujPNjQhj<]ubj’)r(}r((jAUjBjgjCjDjEj•jG}r ((j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr!(j›j!(ujPNjQhj<]r"((j)r#(}r$((jAX*--allow-newer[=pkgs], --allow-older[=pkgs]jBj(jCjDjEj jG}r%((j¢]r&((X--allow-newer[r'(X--allow-older[r((ejL]r)(hÚajK]jI]jJ]jN]r*((h7h~ej¨‰ujPMôjQhj<]r+((jª)r,(}r-((jAj'(jBj#(jCjDjEj­jG}r.((jµj¶jL]jK]jI]jJ]jN]ujPMôjQhj<]r/(jZX--allow-newer[r0(…r1(}r2((jAUjCNjPNjQhjBj,(ubaubj³)r3(}r4((jAX=pkgs]jBj#(jCjDjEj¶jG}r5((jµj¶jL]jK]jI]jJ]jN]ujPMôjQhj<]r6(jZX=pkgs]r7(…r8(}r9((jAUjCNjPNjQhjBj3(ubaubj³)r:(}r;((jAjºjBj#(jCjDjEj¶jG}r<((jµj¶jL]jK]jI]jJ]jN]ujPMôjQhj<]r=(jZX, r>(…r?(}r@((jAUjCNjPNjQhjBj:(ubaubjª)rA(}rB((jAj((jBj#(jCjDjEj­jG}rC((jµj¶jL]jK]jI]jJ]jN]ujPMôjQhj<]rD(jZX--allow-older[rE(…rF(}rG((jAUjCNjPNjQhjBjA(ubaubj³)rH(}rI((jAX=pkgs]jBj#(jCjDjEj¶jG}rJ((jµj¶jL]jK]jI]jJ]jN]ujPMôjQhj<]rK(jZX=pkgs]rL(…rM(}rN((jAUjCNjPNjQhjBjH(ubaubeubjÎ)rO(}rP((jAUjBj(jCjDjEjÑjG}rQ((jI]jJ]jK]jL]jN]ujPMôjQhj<]rR((jq)rS(}rT((jAXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rU(jBjO(jCjDjEjtjG}rV((jI]jJ]jK]jL]jN]ujPM¶jQhj<]rW(jZXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rX(…rY(}rZ((jAjU(jCNjPNjQhjBjS(ubaubjq)r[(}r\((jAXîThe following description focuses on upper bounds and the :option:`--allow-newer` flag, but applies analogously to :option:`--allow-older` and lower bounds. :option:`--allow-newer` and :option:`--allow-older` can be used at the same time.jBjO(jCjDjEjtjG}r]((jI]jJ]jK]jL]jN]ujPM¹jQhj<]r^((jZX:The following description focuses on upper bounds and the r_(…r`(}ra((jAX:The following description focuses on upper bounds and the jCNjPNjQhjBj[(ubj¥)rb(}rc((jAX:option:`--allow-newer`rd(jBj[(jCjDjEj©jG}re((UreftypeXoptionj«ˆj¬X --allow-newerU refdomainXstdrf(jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM¹j<]rg(jz)rh(}ri((jAjd(jG}rj((jI]jJ]rk((j¶jf(X std-optionrl(ejK]jL]jN]ujBjb(j<]rm(jZX --allow-newerrn(…ro(}rp((jAUjBjh(ubajEj‚ubaubjZX" flag, but applies analogously to rq(…rr(}rs((jAX" flag, but applies analogously to jCNjPNjQhjBj[(ubj¥)rt(}ru((jAX:option:`--allow-older`rv(jBj[(jCjDjEj©jG}rw((UreftypeXoptionj«ˆj¬X --allow-olderU refdomainXstdrx(jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM¹j<]ry(jz)rz(}r{((jAjv(jG}r|((jI]jJ]r}((j¶jx(X std-optionr~(ejK]jL]jN]ujBjt(j<]r(jZX --allow-olderr€(…r(}r‚((jAUjBjz(ubajEj‚ubaubjZX and lower bounds. rƒ(…r„(}r…((jAX and lower bounds. jCNjPNjQhjBj[(ubj¥)r†(}r‡((jAX:option:`--allow-newer`rˆ(jBj[(jCjDjEj©jG}r‰((UreftypeXoptionj«ˆj¬X --allow-newerU refdomainXstdrŠ(jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM¹j<]r‹(jz)rŒ(}r((jAjˆ(jG}rŽ((jI]jJ]r((j¶jŠ(X std-optionr(ejK]jL]jN]ujBj†(j<]r‘(jZX --allow-newerr’(…r“(}r”((jAUjBjŒ(ubajEj‚ubaubjZX and r•(…r–(}r—((jAX and jCNjPNjQhjBj[(ubj¥)r˜(}r™((jAX:option:`--allow-older`rš(jBj[(jCjDjEj©jG}r›((UreftypeXoptionj«ˆj¬X --allow-olderU refdomainXstdrœ(jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPM¹j<]r(jz)rž(}rŸ((jAjš(jG}r ((jI]jJ]r¡((j¶jœ(X std-optionr¢(ejK]jL]jN]ujBj˜(j<]r£(jZX --allow-olderr¤(…r¥(}r¦((jAUjBjž(ubajEj‚ubaubjZX can be used at the same time.r§(…r¨(}r©((jAX can be used at the same time.jCNjPNjQhjBj[(ubeubjq)rª(}r«((jAXJIf you want to install a package A that depends on B >= 1.0 && < 2.0, but you have the version 2.0 of B installed, you can compile A against B 2.0 by using ``cabal install --allow-newer=B A``. This works for the whole package index: if A also depends on C that in turn depends on B < 2.0, C's dependency on B will be also relaxed.jBjO(jCjDjEjtjG}r¬((jI]jJ]jK]jL]jN]ujPM¾jQhj<]r­((jZXœIf you want to install a package A that depends on B >= 1.0 && < 2.0, but you have the version 2.0 of B installed, you can compile A against B 2.0 by using r®(…r¯(}r°((jAXœIf you want to install a package A that depends on B >= 1.0 && < 2.0, but you have the version 2.0 of B installed, you can compile A against B 2.0 by using jCNjPNjQhjBjª(ubjz)r±(}r²((jAX#``cabal install --allow-newer=B A``jG}r³((jI]jJ]jK]jL]jN]ujBjª(j<]r´(jZXcabal install --allow-newer=B Arµ(…r¶(}r·((jAUjBj±(ubajEj‚ubjZX. This works for the whole package index: if A also depends on C that in turn depends on B < 2.0, C’s dependency on B will be also relaxed.r¸(…r¹(}rº((jAX‹. This works for the whole package index: if A also depends on C that in turn depends on B < 2.0, C's dependency on B will be also relaxed.jCNjPNjQhjBjª(ubeubjq)r»(}r¼((jAXExample:r½(jBjO(jCjDjEjtjG}r¾((jI]jJ]jK]jL]jN]ujPMÄjQhj<]r¿(jZXExample:rÀ(…rÁ(}rÂ((jAj½(jCNjPNjQhjBj»(ubaubj®)rÃ(}rÄ((jAX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...jBjO(jCjDjEj±jG}rÅ((jµj¶jL]jK]jI]jJ]jN]ujPMÈjQhj<]rÆ(jZX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...rÇ(…rÈ(}rÉ((jAUjBjÃ(ubaubjq)rÊ(}rË((jAXAdditional examples:rÌ(jBjO(jCjDjEjtjG}rÍ((jI]jJ]jK]jL]jN]ujPMÑjQhj<]rÎ(jZXAdditional examples:rÏ(…rÐ(}rÑ((jAjÌ(jCNjPNjQhjBjÊ(ubaubj®)rÒ(}rÓ((jAX-# Relax upper bounds in all dependencies. $ cabal install --allow-newer foo # Relax upper bounds only in dependencies on bar, baz and quux. $ cabal install --allow-newer=bar,baz,quux foo # Relax the upper bound on bar and force bar==2.1. $ cabal install --allow-newer=bar --constraint="bar==2.1" foojBjO(jCjDjEj±jG}rÔ((jµj¶jL]jK]jI]jJ]jN]ujPMÕjQhj<]rÕ(jZX-# Relax upper bounds in all dependencies. $ cabal install --allow-newer foo # Relax upper bounds only in dependencies on bar, baz and quux. $ cabal install --allow-newer=bar,baz,quux foo # Relax the upper bound on bar and force bar==2.1. $ cabal install --allow-newer=bar --constraint="bar==2.1" foorÖ(…r×(}rØ((jAUjBjÒ(ubaubjq)rÙ(}rÚ((jAXÚIt's also possible to limit the scope of :option:`--allow-newer` to single packages with the ``--allow-newer=scope:dep`` syntax. This means that the dependency on ``dep`` will be relaxed only for the package ``scope``.jBjO(jCjDjEjtjG}rÛ((jI]jJ]jK]jL]jN]ujPMÞjQhj<]rÜ((jZX+It’s also possible to limit the scope of rÝ(…rÞ(}rß((jAX)It's also possible to limit the scope of jCNjPNjQhjBjÙ(ubj¥)rà(}rá((jAX:option:`--allow-newer`râ(jBjÙ(jCjDjEj©jG}rã((UreftypeXoptionj«ˆj¬X --allow-newerU refdomainXstdrä(jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMÞj<]rå(jz)ræ(}rç((jAjâ(jG}rè((jI]jJ]ré((j¶jä(X std-optionrê(ejK]jL]jN]ujBjà(j<]rë(jZX --allow-newerrì(…rí(}rî((jAUjBjæ(ubajEj‚ubaubjZX to single packages with the rï(…rð(}rñ((jAX to single packages with the jCNjPNjQhjBjÙ(ubjz)rò(}ró((jAX``--allow-newer=scope:dep``jG}rô((jI]jJ]jK]jL]jN]ujBjÙ(j<]rõ(jZX--allow-newer=scope:deprö(…r÷(}rø((jAUjBjò(ubajEj‚ubjZX+ syntax. This means that the dependency on rù(…rú(}rû((jAX+ syntax. This means that the dependency on jCNjPNjQhjBjÙ(ubjz)rü(}rý((jAX``dep``jG}rþ((jI]jJ]jK]jL]jN]ujBjÙ(j<]rÿ(jZXdepr)…r)}r)(jAUjBjü(ubajEj‚ubjZX& will be relaxed only for the package r)…r)}r)(jAX& will be relaxed only for the package jCNjPNjQhjBjÙ(ubjz)r)}r)(jAX ``scope``jG}r)(jI]jJ]jK]jL]jN]ujBjÙ(j<]r )jZXscoper )…r )}r )(jAUjBj)ubajEj‚ubjZX.…r )}r)(jAX.jCNjPNjQhjBjÙ(ubeubjq)r)}r)(jAXExample:r)jBjO(jCjDjEjtjG}r)(jI]jJ]jK]jL]jN]ujPMãjQhj<]r)jZXExample:r)…r)}r)(jAj)jCNjPNjQhjBj)ubaubj®)r)}r)(jAX‚# Relax upper bound in foo's dependency on base; also relax upper bound in # every package's dependency on lens. $ cabal install --allow-newer=foo:base,lens # Relax upper bounds in foo's dependency on base and bar's dependency # on time; also relax the upper bound in the dependency on lens specified by # any package. $ cabal install --allow-newer=foo:base,lens --allow-newer=bar:timejBjO(jCjDjEj±jG}r)(jµj¶jL]jK]jI]jJ]jN]ujPMçjQhj<]r)jZX‚# Relax upper bound in foo's dependency on base; also relax upper bound in # every package's dependency on lens. $ cabal install --allow-newer=foo:base,lens # Relax upper bounds in foo's dependency on base and bar's dependency # on time; also relax the upper bound in the dependency on lens specified by # any package. $ cabal install --allow-newer=foo:base,lens --allow-newer=bar:timer)…r)}r)(jAUjBj)ubaubjq)r)}r)(jAXìFinally, one can enable :option:`--allow-newer` permanently by setting ``allow-newer: True`` in the ``~/.cabal/config`` file. Enabling 'allow-newer' selectively is also supported in the config file (``allow-newer: foo, bar, baz:base``).jBjO(jCjDjEjtjG}r )(jI]jJ]jK]jL]jN]ujPMðjQhj<]r!)(jZXFinally, one can enable r")…r#)}r$)(jAXFinally, one can enable jCNjPNjQhjBj)ubj¥)r%)}r&)(jAX:option:`--allow-newer`r')jBj)jCjDjEj©jG}r()(UreftypeXoptionj«ˆj¬X --allow-newerU refdomainXstdr))jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j§ujPMðj<]r*)jz)r+)}r,)(jAj')jG}r-)(jI]jJ]r.)(j¶j))X std-optionr/)ejK]jL]jN]ujBj%)j<]r0)jZX --allow-newerr1)…r2)}r3)(jAUjBj+)ubajEj‚ubaubjZX permanently by setting r4)…r5)}r6)(jAX permanently by setting jCNjPNjQhjBj)ubjz)r7)}r8)(jAX``allow-newer: True``jG}r9)(jI]jJ]jK]jL]jN]ujBj)j<]r:)jZXallow-newer: Truer;)…r<)}r=)(jAUjBj7)ubajEj‚ubjZX in the r>)…r?)}r@)(jAX in the jCNjPNjQhjBj)ubjz)rA)}rB)(jAX``~/.cabal/config``jG}rC)(jI]jJ]jK]jL]jN]ujBj)j<]rD)jZX~/.cabal/configrE)…rF)}rG)(jAUjBjA)ubajEj‚ubjZXT file. Enabling ‘allow-newer’ selectively is also supported in the config file (rH)…rI)}rJ)(jAXP file. Enabling 'allow-newer' selectively is also supported in the config file (jCNjPNjQhjBj)ubjz)rK)}rL)(jAX#``allow-newer: foo, bar, baz:base``jG}rM)(jI]jJ]jK]jL]jN]ujBj)j<]rN)jZXallow-newer: foo, bar, baz:baserO)…rP)}rQ)(jAUjBjK)ubajEj‚ubjZX).rR)…rS)}rT)(jAX).jCNjPNjQhjBj)ubeubeubeubjŠ)rU)}rV)(jAUjBjgjCNjEjjG}rW)(jL]jK]jI]jJ]jN]Uentries]rX)(jX<setup-configure command line option; --constraint=constrainthÀUNtrY)aujPNjQhj<]ubj’)rZ)}r[)(jAUjBjgjCNjEj•jG}r\)(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr])j›j])ujPNjQhj<]r^)(j)r_)}r`)(jAX--constraint=constraintjBjZ)jCjDjEj jG}ra)(j¢]rb)X --constraintrc)ajL]rd)hÀajK]jI]jJ]jN]re)haj¨‰ujPMIjQhj<]rf)(jª)rg)}rh)(jAjc)jBj_)jCjDjEj­jG}ri)(jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]rj)jZX --constraintrk)…rl)}rm)(jAUjCNjPNjQhjBjg)ubaubj³)rn)}ro)(jAX =constraintjBj_)jCjDjEj¶jG}rp)(jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]rq)jZX =constraintrr)…rs)}rt)(jAUjCNjPNjQhjBjn)ubaubeubjÎ)ru)}rv)(jAUjBjZ)jCjDjEjÑjG}rw)(jI]jJ]jK]jL]jN]ujPMIjQhj<]rx)(jq)ry)}rz)(jAXÕRestrict solutions involving a package to given version bounds, flag settings, and other properties. For example, to consider only install plans that use version 2.1 of ``bar`` or do not use ``bar`` at all, write:jBju)jCjDjEjtjG}r{)(jI]jJ]jK]jL]jN]ujPM÷jQhj<]r|)(jZX©Restrict solutions involving a package to given version bounds, flag settings, and other properties. For example, to consider only install plans that use version 2.1 of r})…r~)}r)(jAX©Restrict solutions involving a package to given version bounds, flag settings, and other properties. For example, to consider only install plans that use version 2.1 of jCNjPNjQhjBjy)ubjz)r€)}r)(jAX``bar``jG}r‚)(jI]jJ]jK]jL]jN]ujBjy)j<]rƒ)jZXbarr„)…r…)}r†)(jAUjBj€)ubajEj‚ubjZX or do not use r‡)…rˆ)}r‰)(jAX or do not use jCNjPNjQhjBjy)ubjz)rŠ)}r‹)(jAX``bar``jG}rŒ)(jI]jJ]jK]jL]jN]ujBjy)j<]r)jZXbarrŽ)…r)}r)(jAUjBjŠ)ubajEj‚ubjZX at all, write:r‘)…r’)}r“)(jAX at all, write:jCNjPNjQhjBjy)ubeubj®)r”)}r•)(jAX)$ cabal install --constraint="bar == 2.1"jBju)jCjDjEj±jG}r–)(jµj¶jL]jK]jI]jJ]jN]ujPMþjQhj<]r—)jZX)$ cabal install --constraint="bar == 2.1"r˜)…r™)}rš)(jAUjBj”)ubaubjq)r›)}rœ)(jAXƒVersion bounds have the same syntax as ``build-depends``. As a special case, the following prevents ``bar`` from being used at all:jBju)jCjDjEjtjG}r)(jI]jJ]jK]jL]jN]ujPMjQhj<]rž)(jZX'Version bounds have the same syntax as rŸ)…r )}r¡)(jAX'Version bounds have the same syntax as jCNjPNjQhjBj›)ubjz)r¢)}r£)(jAX``build-depends``jG}r¤)(jI]jJ]jK]jL]jN]ujBj›)j<]r¥)jZX build-dependsr¦)…r§)}r¨)(jAUjBj¢)ubajEj‚ubjZX,. As a special case, the following prevents r©)…rª)}r«)(jAX,. As a special case, the following prevents jCNjPNjQhjBj›)ubjz)r¬)}r­)(jAX``bar``jG}r®)(jI]jJ]jK]jL]jN]ujBj›)j<]r¯)jZXbarr°)…r±)}r²)(jAUjBj¬)ubajEj‚ubjZX from being used at all:r³)…r´)}rµ)(jAX from being used at all:jCNjPNjQhjBj›)ubeubj®)r¶)}r·)(jAX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"jBju)jCjDjEj±jG}r¸)(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]r¹)jZX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"rº)…r»)}r¼)(jAUjBj¶)ubaubjq)r½)}r¾)(jAX&You can also specify flag assignments:r¿)jBju)jCjDjEjtjG}rÀ)(jI]jJ]jK]jL]jN]ujPM jQhj<]rÁ)jZX&You can also specify flag assignments:rÂ)…rÃ)}rÄ)(jAj¿)jCNjPNjQhjBj½)ubaubj®)rÅ)}rÆ)(jAX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"jBju)jCjDjEj±jG}rÇ)(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rÈ)jZX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"rÉ)…rÊ)}rË)(jAUjBjÅ)ubaubjq)rÌ)}rÍ)(jAXWTo specify multiple constraints, you may pass the ``constraint`` option multiple times.jBju)jCjDjEjtjG}rÎ)(jI]jJ]jK]jL]jN]ujPMjQhj<]rÏ)(jZX2To specify multiple constraints, you may pass the rÐ)…rÑ)}rÒ)(jAX2To specify multiple constraints, you may pass the jCNjPNjQhjBjÌ)ubjz)rÓ)}rÔ)(jAX``constraint``jG}rÕ)(jI]jJ]jK]jL]jN]ujBjÌ)j<]rÖ)jZX constraintr×)…rØ)}rÙ)(jAUjBjÓ)ubajEj‚ubjZX option multiple times.rÚ)…rÛ)}rÜ)(jAX option multiple times.jCNjPNjQhjBjÌ)ubeubjq)rÝ)}rÞ)(jAXYThere are also some more specialized constraints, which most people don't generally need:rß)jBju)jCjDjEjtjG}rà)(jI]jJ]jK]jL]jN]ujPMjQhj<]rá)jZX[There are also some more specialized constraints, which most people don’t generally need:râ)…rã)}rä)(jAjß)jCNjPNjQhjBjÝ)ubaubj®)rå)}ræ)(jAXö# Require that a version of bar be used that is already installed in # the global package database. $ cabal install --constraint="bar installed" # Require the local source copy of bar to be used. # (Note: By default, if we have a local package we will # automatically use it, so it will generally not be necessary to # specify this.) $ cabal install --constraint="bar source" # Require that bar have test suites and benchmarks enabled. $ cabal install --constraint="bar test" --constraint="bar bench"jBju)jCjDjEj±jG}rç)(jµj¶jL]jK]jI]jJ]jN]ujPMjQhj<]rè)jZXö# Require that a version of bar be used that is already installed in # the global package database. $ cabal install --constraint="bar installed" # Require the local source copy of bar to be used. # (Note: By default, if we have a local package we will # automatically use it, so it will generally not be necessary to # specify this.) $ cabal install --constraint="bar source" # Require that bar have test suites and benchmarks enabled. $ cabal install --constraint="bar test" --constraint="bar bench"ré)…rê)}rë)(jAUjBjå)ubaubjq)rì)}rí)(jAXÌBy default, constraints only apply to build dependencies (``build-depends``), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the ``Setup.hs`` script of any package (``setup-depends``) nor do they apply to build tools (``build-tool-depends``) or the dependencies of build tools. To explicitly apply a constraint to a setup or build tool dependency, you can add a qualifier to the constraint as follows:jBju)jCjDjEjtjG}rî)(jI]jJ]jK]jL]jN]ujPM'jQhj<]rï)(jZX:By default, constraints only apply to build dependencies (rð)…rñ)}rò)(jAX:By default, constraints only apply to build dependencies (jCNjPNjQhjBjì)ubjz)ró)}rô)(jAX``build-depends``jG}rõ)(jI]jJ]jK]jL]jN]ujBjì)j<]rö)jZX build-dependsr÷)…rø)}rù)(jAUjBjó)ubajEj‚ubjZXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the rú)…rû)}rü)(jAXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the jCNjPNjQhjBjì)ubjz)rý)}rþ)(jAX ``Setup.hs``jG}rÿ)(jI]jJ]jK]jL]jN]ujBjì)j<]r*jZXSetup.hsr*…r*}r*(jAUjBjý)ubajEj‚ubjZX script of any package (r*…r*}r*(jAX script of any package (jCNjPNjQhjBjì)ubjz)r*}r*(jAX``setup-depends``jG}r *(jI]jJ]jK]jL]jN]ujBjì)j<]r *jZX setup-dependsr *…r *}r *(jAUjBj*ubajEj‚ubjZX$) nor do they apply to build tools (r*…r*}r*(jAX$) nor do they apply to build tools (jCNjPNjQhjBjì)ubjz)r*}r*(jAX``build-tool-depends``jG}r*(jI]jJ]jK]jL]jN]ujBjì)j<]r*jZXbuild-tool-dependsr*…r*}r*(jAUjBj*ubajEj‚ubjZX¡) or the dependencies of build tools. To explicitly apply a constraint to a setup or build tool dependency, you can add a qualifier to the constraint as follows:r*…r*}r*(jAX¡) or the dependencies of build tools. To explicitly apply a constraint to a setup or build tool dependency, you can add a qualifier to the constraint as follows:jCNjPNjQhjBjì)ubeubj®)r*}r*(jAXž# Example use of the 'any' qualifier. This constraint # applies to package bar anywhere in the dependency graph. $ cabal install --constraint="any.bar == 1.0"jBju)jCjDjEj±jG}r*(jµj¶jL]jK]jI]jJ]jN]ujPM3jQhj<]r*jZXž# Example use of the 'any' qualifier. This constraint # applies to package bar anywhere in the dependency graph. $ cabal install --constraint="any.bar == 1.0"r*…r *}r!*(jAUjBj*ubaubj®)r"*}r#*(jAXP# Example uses of 'setup' qualifiers. # This constraint applies to package bar when it is a # dependency of any Setup.hs script. $ cabal install --constraint="setup.bar == 1.0" # This constraint applies to package bar when it is a # dependency of the Setup.hs script of package foo. $ cabal install --constraint="foo:setup.bar == 1.0"jBju)jCjDjEj±jG}r$*(jµj¶jL]jK]jI]jJ]jN]ujPM9jQhj<]r%*jZXP# Example uses of 'setup' qualifiers. # This constraint applies to package bar when it is a # dependency of any Setup.hs script. $ cabal install --constraint="setup.bar == 1.0" # This constraint applies to package bar when it is a # dependency of the Setup.hs script of package foo. $ cabal install --constraint="foo:setup.bar == 1.0"r&*…r'*}r(*(jAUjBj"*ubaubcdocutils.nodes comment r)*)r**}r+*(jAXBTODO: Uncomment this example once we decide on a syntax for 'exe'.jBju)jCjDjEUcommentr,*jG}r-*(jµj¶jL]jK]jI]jJ]jN]ujPMCjQhj<]r.*jZXBTODO: Uncomment this example once we decide on a syntax for 'exe'.r/*…r0*}r1*(jAUjBj**ubaubj)*)r2*}r3*(jAXï# Example use of the 'exe' (executable build tool) # qualifier. This constraint applies to package baz when it # is a dependency of the build tool bar being used to # build package foo. $ cabal install --constraint="foo:bar:exe.baz == 1.0"jBju)jCjDjEj,*jG}r4*(jµj¶jL]jK]jI]jJ]jN]ujPMHjQhj<]r5*jZXï# Example use of the 'exe' (executable build tool) # qualifier. This constraint applies to package baz when it # is a dependency of the build tool bar being used to # build package foo. $ cabal install --constraint="foo:bar:exe.baz == 1.0"r6*…r7*}r8*(jAUjBj2*ubaubeubeubjŠ)r9*}r:*(jAUjBjgjCjDjEjjG}r;*(jL]jK]jI]jJ]jN]Uentries]r<*(jX<setup-configure command line option; --preference=preferencehêUNtr=*aujPNjQhj<]ubj’)r>*}r?*(jAUjBjgjCjDjEj•jG}r@*(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrA*j›jA*ujPNjQhj<]rB*(j)rC*}rD*(jAX--preference=preferencejBj>*jCjDjEj jG}rE*(j¢]rF*X --preferencerG*ajL]rH*hêajK]jI]jJ]jN]rI*hHaj¨‰ujPMNjQhj<]rJ*(jª)rK*}rL*(jAjG*jBjC*jCjDjEj­jG}rM*(jµj¶jL]jK]jI]jJ]jN]ujPMNjQhj<]rN*jZX --preferencerO*…rP*}rQ*(jAUjCNjPNjQhjBjK*ubaubj³)rR*}rS*(jAX =preferencejBjC*jCjDjEj¶jG}rT*(jµj¶jL]jK]jI]jJ]jN]ujPMNjQhj<]rU*jZX =preferencerV*…rW*}rX*(jAUjCNjPNjQhjBjR*ubaubeubjÎ)rY*}rZ*(jAUjBj>*jCjDjEjÑjG}r[*(jI]jJ]jK]jL]jN]ujPMNjQhj<]r\*jq)r]*}r^*(jAX‚Specify a soft constraint on versions of a package. The solver will attempt to satisfy these preferences on a "best-effort" basis.r_*jBjY*jCjDjEjtjG}r`*(jI]jJ]jK]jL]jN]ujPMLjQhj<]ra*jZX†Specify a soft constraint on versions of a package. The solver will attempt to satisfy these preferences on a “best-effort†basis.rb*…rc*}rd*(jAj_*jCNjPNjQhjBj]*ubaubaubeubjÙ)re*}rf*(jAX.. _setup-build:jBjgjCjDjEjÜjG}rg*(jL]jK]jI]jJ]jN]jÞhÃujPMOjQhj<]ubeubeubj>)rh*}ri*(jAUjBjßjCjDjá}rj*h je*sjEjFjG}rk*(jI]jJ]jK]jL]rl*(hÃj3ejN]rm*(h—h eujPMRjQhjæ}rn*hÃje*sj<]ro*(jS)rp*}rq*(jAX setup buildrr*jBjh*jCjDjEjWjG}rs*(jI]jJ]jK]jL]jN]ujPMRjQhj<]rt*jZX setup buildru*…rv*}rw*(jAjr*jCNjPNjQhjBjp*ubaubjq)rx*}ry*(jAX\Perform any preprocessing or compilation needed to make this package ready for installation.rz*jBjh*jCjDjEjtjG}r{*(jI]jJ]jK]jL]jN]ujPMTjQhj<]r|*jZX\Perform any preprocessing or compilation needed to make this package ready for installation.r}*…r~*}r*(jAjz*jCNjPNjQhjBjx*ubaubjq)r€*}r*(jAX)This command takes the following options:r‚*jBjh*jCjDjEjtjG}rƒ*(jI]jJ]jK]jL]jN]ujPMWjQhj<]r„*jZX)This command takes the following options:r…*…r†*}r‡*(jAj‚*jCNjPNjQhjBj€*ubaubjŠ)rˆ*}r‰*(jAUjBjh*jCjDjEjjG}rŠ*(jL]jK]jI]jJ]jN]Uentries]r‹*(jXMsetup-build command line option; --prog-options=options, --prog-option=optionh²UNtrŒ*aujPNjQhj<]ubj’)r*}rŽ*(jAUjBjh*jCjDjEj•jG}r*(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr*j›j*ujPNjQhj<]r‘*(j)r’*}r“*(jAX,--prog-options=options, --prog-option=optionjBj*jCjDjEj jG}r”*(j¢]r•*(X--prog-optionsr–*X --prog-optionr—*ejL]r˜*h²ajK]jI]jJ]jN]r™*(hphej¨‰ujPMcjQhj<]rš*(jª)r›*}rœ*(jAj–*jBj’*jCjDjEj­jG}r*(jµj¶jL]jK]jI]jJ]jN]ujPMcjQhj<]rž*jZX--prog-optionsrŸ*…r *}r¡*(jAUjCNjPNjQhjBj›*ubaubj³)r¢*}r£*(jAX=optionsjBj’*jCjDjEj¶jG}r¤*(jµj¶jL]jK]jI]jJ]jN]ujPMcjQhj<]r¥*jZX=optionsr¦*…r§*}r¨*(jAUjCNjPNjQhjBj¢*ubaubj³)r©*}rª*(jAjºjBj’*jCjDjEj¶jG}r«*(jµj¶jL]jK]jI]jJ]jN]ujPMcjQhj<]r¬*jZX, r­*…r®*}r¯*(jAUjCNjPNjQhjBj©*ubaubjª)r°*}r±*(jAj—*jBj’*jCjDjEj­jG}r²*(jµj¶jL]jK]jI]jJ]jN]ujPMcjQhj<]r³*jZX --prog-optionr´*…rµ*}r¶*(jAUjCNjPNjQhjBj°*ubaubj³)r·*}r¸*(jAX=optionjBj’*jCjDjEj¶jG}r¹*(jµj¶jL]jK]jI]jJ]jN]ujPMcjQhj<]rº*jZX=optionr»*…r¼*}r½*(jAUjCNjPNjQhjBj·*ubaubeubjÎ)r¾*}r¿*(jAUjBj*jCjDjEjÑjG}rÀ*(jI]jJ]jK]jL]jN]ujPMcjQhj<]rÁ*jq)rÂ*}rÃ*(jAXiThese are mostly the same as the `options configure step <#setup-configure>`__. Unlike the options specified at the configure step, any program options specified at the build step are not persistent but are used for that invocation only. They options specified at the build step are in addition not in replacement of any options specified at the configure step.jBj¾*jCjDjEjtjG}rÄ*(jI]jJ]jK]jL]jN]ujPM]jQhj<]rÅ*(jZX!These are mostly the same as the rÆ*…rÇ*}rÈ*(jAX!These are mostly the same as the jCNjPNjQhjBjÂ*ubj”)rÉ*}rÊ*(jAX-`options configure step <#setup-configure>`__jG}rË*(UnameXoptions configure stepjâX#setup-configurejL]jK]jI]jJ]jN]ujBjÂ*j<]rÌ*jZXoptions configure steprÍ*…rÎ*}rÏ*(jAUjBjÉ*ubajEjubjZX. Unlike the options specified at the configure step, any program options specified at the build step are not persistent but are used for that invocation only. They options specified at the build step are in addition not in replacement of any options specified at the configure step.rÐ*…rÑ*}rÒ*(jAX. Unlike the options specified at the configure step, any program options specified at the build step are not persistent but are used for that invocation only. They options specified at the build step are in addition not in replacement of any options specified at the configure step.jCNjPNjQhjBjÂ*ubeubaubeubjÙ)rÓ*}rÔ*(jAX.. _setup-haddock:jBjh*jCjDjEjÜjG}rÕ*(jL]jK]jI]jJ]jN]jÞh°ujPMdjQhj<]ubeubj>)rÖ*}r×*(jAUjBjßjCjDjá}rØ*h jÓ*sjEjFjG}rÙ*(jI]jJ]jK]jL]rÚ*(h°j)ejN]rÛ*(hh eujPMgjQhjæ}rÜ*h°jÓ*sj<]rÝ*(jS)rÞ*}rß*(jAX setup haddockrà*jBjÖ*jCjDjEjWjG}rá*(jI]jJ]jK]jL]jN]ujPMgjQhj<]râ*jZX setup haddockrã*…rä*}rå*(jAjà*jCNjPNjQhjBjÞ*ubaubjq)ræ*}rç*(jAXËBuild the documentation for the package using Haddock_. By default, only the documentation for the exposed modules is generated (but see the :option:`--executables` and :option:`--internal` flags below).jBjÖ*jCjDjEjtjG}rè*(jI]jJ]jK]jL]jN]ujPMkjQhj<]ré*(jZX.Build the documentation for the package using rê*…rë*}rì*(jAX.Build the documentation for the package using jCNjPNjQhjBjæ*ubj”)rí*}rî*(jAXHaddock_jàKjBjæ*jEjjG}rï*(UnameXHaddockjâXhttp://www.haskell.org/haddock/rð*jL]jK]jI]jJ]jN]uj<]rñ*jZXHaddockrò*…ró*}rô*(jAUjBjí*ubaubjZXW. By default, only the documentation for the exposed modules is generated (but see the rõ*…rö*}r÷*(jAXW. By default, only the documentation for the exposed modules is generated (but see the jCNjPNjQhjBjæ*ubj¥)rø*}rù*(jAX:option:`--executables`rú*jBjæ*jCjDjEj©jG}rû*(UreftypeXoptionj«ˆj¬X --executablesU refdomainXstdrü*jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°X setup-haddockrý*ujPMkj<]rþ*jz)rÿ*}r+(jAjú*jG}r+(jI]jJ]r+(j¶jü*X std-optionr+ejK]jL]jN]ujBjø*j<]r+jZX --executablesr+…r+}r+(jAUjBjÿ*ubajEj‚ubaubjZX and r+…r +}r +(jAX and jCNjPNjQhjBjæ*ubj¥)r +}r +(jAX:option:`--internal`r +jBjæ*jCjDjEj©jG}r+(UreftypeXoptionj«ˆj¬X --internalU refdomainXstdr+jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°jý*ujPMkj<]r+jz)r+}r+(jAj +jG}r+(jI]jJ]r+(j¶j+X std-optionr+ejK]jL]jN]ujBj +j<]r+jZX --internalr+…r+}r+(jAUjBj+ubajEj‚ubaubjZX flags below).r+…r+}r+(jAX flags below).jCNjPNjQhjBjæ*ubeubjq)r+}r+(jAX)This command takes the following options:r+jBjÖ*jCjDjEjtjG}r +(jI]jJ]jK]jL]jN]ujPMojQhj<]r!+jZX)This command takes the following options:r"+…r#+}r$+(jAj+jCNjPNjQhjBj+ubaubjŠ)r%+}r&+(jAUjBjÖ*jCjDjEjjG}r'+(jL]jK]jI]jJ]jN]Uentries]r(+(jX+setup-haddock command line option; --hooglehÙUNtr)+aujPNjQhj<]ubj’)r*+}r++(jAUjBjÖ*jCjDjEj•jG}r,+(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr-+j›j-+ujPNjQhj<]r.+(j)r/+}r0+(jAX--hoogler1+jBj*+jCjDjEj jG}r2+(j¢]r3+j1+ajL]r4+hÙajK]jI]jJ]jN]r5+h6aj¨‰ujPMwjQhj<]r6+(jª)r7+}r8+(jAj1+jBj/+jCjDjEj­jG}r9+(jµj¶jL]jK]jI]jJ]jN]ujPMwjQhj<]r:+jZX--hoogler;+…r<+}r=+(jAUjCNjPNjQhjBj7+ubaubj³)r>+}r?+(jAUjBj/+jCjDjEj¶jG}r@+(jµj¶jL]jK]jI]jJ]jN]ujPMwjQhj<]ubeubjÎ)rA+}rB+(jAUjBj*+jCjDjEjÑjG}rC+(jI]jJ]jK]jL]jN]ujPMwjQhj<]rD+jq)rE+}rF+(jAXºGenerate a file ``dist/doc/html/``\ *pkgid*\ ``.txt``, which can be converted by Hoogle_ into a database for searching. This is equivalent to running Haddock_ with the ``--hoogle`` flag.jBjA+jCjDjEjtjG}rG+(jI]jJ]jK]jL]jN]ujPMsjQhj<]rH+(jZXGenerate a file rI+…rJ+}rK+(jAXGenerate a file jCNjPNjQhjBjE+ubjz)rL+}rM+(jAX``dist/doc/html/``jG}rN+(jI]jJ]jK]jL]jN]ujBjE+j<]rO+jZXdist/doc/html/rP+…rQ+}rR+(jAUjBjL+ubajEj‚ubjZX…rS+}rT+(jAX\ rU+jCNjPNjQhjBjE+ubjµ)rV+}rW+(jAX*pkgid*jG}rX+(jI]jJ]jK]jL]jN]ujBjE+j<]rY+jZXpkgidrZ+…r[+}r\+(jAUjBjV+ubajEj½ubjZX…r]+}r^+(jAjU+jBjE+ubjz)r_+}r`+(jAX``.txt``jG}ra+(jI]jJ]jK]jL]jN]ujBjE+j<]rb+jZX.txtrc+…rd+}re+(jAUjBj_+ubajEj‚ubjZX, which can be converted by rf+…rg+}rh+(jAX, which can be converted by jCNjPNjQhjBjE+ubj”)ri+}rj+(jAXHoogle_jàKjBjE+jEjjG}rk+(UnameXHooglejâXhttp://www.haskell.org/hoogle/rl+jL]jK]jI]jJ]jN]uj<]rm+jZXHooglern+…ro+}rp+(jAUjBji+ubaubjZX> into a database for searching. This is equivalent to running rq+…rr+}rs+(jAX> into a database for searching. This is equivalent to running jCNjPNjQhjBjE+ubj”)rt+}ru+(jAXHaddock_jàKjBjE+jEjjG}rv+(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]rw+jZXHaddockrx+…ry+}rz+(jAUjBjt+ubaubjZX with the r{+…r|+}r}+(jAX with the jCNjPNjQhjBjE+ubjz)r~+}r+(jAX ``--hoogle``jG}r€+(jI]jJ]jK]jL]jN]ujBjE+j<]r+jZX--hoogler‚+…rƒ+}r„+(jAUjBj~+ubajEj‚ubjZX flag.r…+…r†+}r‡+(jAX flag.jCNjPNjQhjBjE+ubeubaubeubjŠ)rˆ+}r‰+(jAUjBjÖ*jCjDjEjjG}rŠ+(jL]jK]jI]jJ]jN]Uentries]r‹+(jX6setup-haddock command line option; --html-location=urljUNtrŒ+aujPNjQhj<]ubj’)r+}rŽ+(jAUjBjÖ*jCjDjEj•jG}r+(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr+j›j+ujPNjQhj<]r‘+(j)r’+}r“+(jAX--html-location=urljBj+jCjDjEj jG}r”+(j¢]r•+X--html-locationr–+ajL]r—+jajK]jI]jJ]jN]r˜+hzaj¨‰ujPM‡jQhj<]r™+(jª)rš+}r›+(jAj–+jBj’+jCjDjEj­jG}rœ+(jµj¶jL]jK]jI]jJ]jN]ujPM‡jQhj<]r+jZX--html-locationrž+…rŸ+}r +(jAUjCNjPNjQhjBjš+ubaubj³)r¡+}r¢+(jAX=urljBj’+jCjDjEj¶jG}r£+(jµj¶jL]jK]jI]jJ]jN]ujPM‡jQhj<]r¤+jZX=urlr¥+…r¦+}r§+(jAUjCNjPNjQhjBj¡+ubaubeubjÎ)r¨+}r©+(jAUjBj+jCjDjEjÑjG}rª+(jI]jJ]jK]jL]jN]ujPM‡jQhj<]r«+(jq)r¬+}r­+(jAXoSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (`see listing <#paths-in-the-simple-build-system>`__) 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:jBj¨+jCjDjEjtjG}r®+(jI]jJ]jK]jL]jN]ujPMzjQhj<]r¯+(jZXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (r°+…r±+}r²+(jAXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (jCNjPNjQhjBj¬+ubj”)r³+}r´+(jAX3`see listing <#paths-in-the-simple-build-system>`__jG}rµ+(UnameX see listingjâX!#paths-in-the-simple-build-systemjL]jK]jI]jJ]jN]ujBj¬+j<]r¶+jZX see listingr·+…r¸+}r¹+(jAUjBj³+ubajEjubjZXÅ) 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 rº+…r»+}r¼+(jAXÅ) 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 jCNjPNjQhjBj¬+ubj”)r½+}r¾+(jAXHackage_jàKjBj¬+jEjjG}r¿+(UnameXHackagejâjãjL]jK]jI]jJ]jN]uj<]rÀ+jZXHackagerÁ+…rÂ+}rÃ+(jAUjBj½+ubaubjZX pages:rÄ+…rÅ+}rÆ+(jAX pages:jCNjPNjQhjBj¬+ubeubcdocutils.nodes block_quote rÇ+)rÈ+}rÉ+(jAUjBj¨+jCjDjEU block_quoterÊ+jG}rË+(jI]jJ]jK]jL]jN]ujPNjQhj<]rÌ+jq)rÍ+}rÎ+(jAX`setup haddock --html-location='http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'jBjÈ+jCjDjEjtjG}rÏ+(jI]jJ]jK]jL]jN]ujPMj<]rÐ+(jZX"setup haddock –html-location=’rÑ+…rÒ+}rÓ+(jAXsetup haddock --html-location='jBjÍ+ubj”)rÔ+}rÕ+(jAX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlrÖ+jG}r×+(UrefurijÖ+jL]jK]jI]jJ]jN]ujBjÍ+j<]rØ+jZX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlrÙ+…rÚ+}rÛ+(jAUjBjÔ+ubajEjubjZX’…rÜ+}rÝ+(jAX'jBjÍ+ubeubaubjq)rÞ+}rß+(jAX±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``).jBj¨+jCjDjEjtjG}rà+(jI]jJ]jK]jL]jN]ujPM„jQhj<]rá+(jZX¤Here the argument is quoted to prevent substitution by the shell. If this option is omitted, the location for each package is obtained using the package tool (e.g. râ+…rã+}rä+(jAX¤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. jCNjPNjQhjBjÞ+ubjz)rå+}ræ+(jAX ``ghc-pkg``jG}rç+(jI]jJ]jK]jL]jN]ujBjÞ+j<]rè+jZXghc-pkgré+…rê+}rë+(jAUjBjå+ubajEj‚ubjZX).rì+…rí+}rî+(jAX).jCNjPNjQhjBjÞ+ubeubeubeubjŠ)rï+}rð+(jAUjBjÖ*jCjDjEjjG}rñ+(jL]jK]jI]jJ]jN]Uentries]rò+(jX0setup-haddock command line option; --executablesj/UNtró+aujPNjQhj<]ubj’)rô+}rõ+(jAUjBjÖ*jCjDjEj•jG}rö+(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr÷+j›j÷+ujPNjQhj<]rø+(j)rù+}rú+(jAX --executablesrû+jBjô+jCjDjEj jG}rü+(j¢]rý+jû+ajL]rþ+j/ajK]jI]jJ]jN]rÿ+h“aj¨‰ujPMŒjQhj<]r,(jª)r,}r,(jAjû+jBjù+jCjDjEj­jG}r,(jµj¶jL]jK]jI]jJ]jN]ujPMŒjQhj<]r,jZX --executablesr,…r,}r,(jAUjCNjPNjQhjBj,ubaubj³)r,}r ,(jAUjBjù+jCjDjEj¶jG}r ,(jµj¶jL]jK]jI]jJ]jN]ujPMŒjQhj<]ubeubjÎ)r ,}r ,(jAUjBjô+jCjDjEjÑjG}r ,(jI]jJ]jK]jL]jN]ujPMŒjQhj<]r,jq)r,}r,(jAXzAlso run Haddock_ for the modules of all the executable programs. By default Haddock_ is run only on the exported modules.jBj ,jCjDjEjtjG}r,(jI]jJ]jK]jL]jN]ujPMŠjQhj<]r,(jZX Also run r,…r,}r,(jAX Also run jCNjPNjQhjBj,ubj”)r,}r,(jAXHaddock_jàKjBj,jEjjG}r,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r,jZXHaddockr,…r,}r,(jAUjBj,ubaubjZX< for the modules of all the executable programs. By default r,…r,}r,(jAX< for the modules of all the executable programs. By default jCNjPNjQhjBj,ubj”)r ,}r!,(jAXHaddock_jàKjBj,jEjjG}r",(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r#,jZXHaddockr$,…r%,}r&,(jAUjBj ,ubaubjZX% is run only on the exported modules.r',…r(,}r),(jAX% is run only on the exported modules.jCNjPNjQhjBj,ubeubaubeubjŠ)r*,}r+,(jAUjBjÖ*jCjDjEjjG}r,,(jL]jK]jI]jJ]jN]Uentries]r-,(jX-setup-haddock command line option; --internalhÒUNtr.,aujPNjQhj<]ubj’)r/,}r0,(jAUjBjÖ*jCjDjEj•jG}r1,(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr2,j›j2,ujPNjQhj<]r3,(j)r4,}r5,(jAX --internalr6,jBj/,jCjDjEj jG}r7,(j¢]r8,j6,ajL]r9,hÒajK]jI]jJ]jN]r:,h/aj¨‰ujPM“jQhj<]r;,(jª)r<,}r=,(jAj6,jBj4,jCjDjEj­jG}r>,(jµj¶jL]jK]jI]jJ]jN]ujPM“jQhj<]r?,jZX --internalr@,…rA,}rB,(jAUjCNjPNjQhjBj<,ubaubj³)rC,}rD,(jAUjBj4,jCjDjEj¶jG}rE,(jµj¶jL]jK]jI]jJ]jN]ujPM“jQhj<]ubeubjÎ)rF,}rG,(jAUjBj/,jCjDjEjÑjG}rH,(jI]jJ]jK]jL]jN]ujPM“jQhj<]rI,jq)rJ,}rK,(jAX„Run Haddock_ for the all modules, including unexposed ones, and make Haddock_ generate documentation for unexported symbols as well.jBjF,jCjDjEjtjG}rL,(jI]jJ]jK]jL]jN]ujPMjQhj<]rM,(jZXRun rN,…rO,}rP,(jAXRun jCNjPNjQhjBjJ,ubj”)rQ,}rR,(jAXHaddock_jàKjBjJ,jEjjG}rS,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]rT,jZXHaddockrU,…rV,}rW,(jAUjBjQ,ubaubjZX9 for the all modules, including unexposed ones, and make rX,…rY,}rZ,(jAX9 for the all modules, including unexposed ones, and make jCNjPNjQhjBjJ,ubj”)r[,}r\,(jAXHaddock_jàKjBjJ,jEjjG}r],(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r^,jZXHaddockr_,…r`,}ra,(jAUjBj[,ubaubjZX7 generate documentation for unexported symbols as well.rb,…rc,}rd,(jAX7 generate documentation for unexported symbols as well.jCNjPNjQhjBjJ,ubeubaubeubjŠ)re,}rf,(jAUjBjÖ*jCjDjEjjG}rg,(jL]jK]jI]jJ]jN]Uentries]rh,(jX-setup-haddock command line option; --css=pathhèUNtri,aujPNjQhj<]ubj’)rj,}rk,(jAUjBjÖ*jCjDjEj•jG}rl,(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrm,j›jm,ujPNjQhj<]rn,(j)ro,}rp,(jAX --css=pathjBjj,jCjDjEj jG}rq,(j¢]rr,X--cssrs,ajL]rt,hèajK]jI]jJ]jN]ru,hFaj¨‰ujPM›jQhj<]rv,(jª)rw,}rx,(jAjs,jBjo,jCjDjEj­jG}ry,(jµj¶jL]jK]jI]jJ]jN]ujPM›jQhj<]rz,jZX--cssr{,…r|,}r},(jAUjCNjPNjQhjBjw,ubaubj³)r~,}r,(jAX=pathjBjo,jCjDjEj¶jG}r€,(jµj¶jL]jK]jI]jJ]jN]ujPM›jQhj<]r,jZX=pathr‚,…rƒ,}r„,(jAUjCNjPNjQhjBj~,ubaubeubjÎ)r…,}r†,(jAUjBjj,jCjDjEjÑjG}r‡,(jI]jJ]jK]jL]jN]ujPM›jQhj<]rˆ,jq)r‰,}rŠ,(jAXÃThe argument *path* denotes a CSS file, which is passed to Haddock_ and used to set the style of the generated documentation. This is only needed to override the default style that Haddock_ uses.jBj…,jCjDjEjtjG}r‹,(jI]jJ]jK]jL]jN]ujPM–jQhj<]rŒ,(jZX The argument r,…rŽ,}r,(jAX The argument jCNjPNjQhjBj‰,ubjµ)r,}r‘,(jAX*path*jG}r’,(jI]jJ]jK]jL]jN]ujBj‰,j<]r“,jZXpathr”,…r•,}r–,(jAUjBj,ubajEj½ubjZX( denotes a CSS file, which is passed to r—,…r˜,}r™,(jAX( denotes a CSS file, which is passed to jCNjPNjQhjBj‰,ubj”)rš,}r›,(jAXHaddock_jàKjBj‰,jEjjG}rœ,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r,jZXHaddockrž,…rŸ,}r ,(jAUjBjš,ubaubjZXr and used to set the style of the generated documentation. This is only needed to override the default style that r¡,…r¢,}r£,(jAXr and used to set the style of the generated documentation. This is only needed to override the default style that jCNjPNjQhjBj‰,ubj”)r¤,}r¥,(jAXHaddock_jàKjBj‰,jEjjG}r¦,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r§,jZXHaddockr¨,…r©,}rª,(jAUjBj¤,ubaubjZX uses.r«,…r¬,}r­,(jAX uses.jCNjPNjQhjBj‰,ubeubaubeubjŠ)r®,}r¯,(jAUjBjÖ*jCjDjEjjG}r°,(jL]jK]jI]jJ]jN]Uentries]r±,(jX5setup-haddock command line option; --hyperlink-sourcejUNtr²,aujPNjQhj<]ubj’)r³,}r´,(jAUjBjÖ*jCjDjEj•jG}rµ,(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¶,j›j¶,ujPNjQhj<]r·,(j)r¸,}r¹,(jAX--hyperlink-sourcerº,jBj³,jCjDjEj jG}r»,(j¢]r¼,jº,ajL]r½,jajK]jI]jJ]jN]r¾,h€aj¨‰ujPM¢jQhj<]r¿,(jª)rÀ,}rÁ,(jAjº,jBj¸,jCjDjEj­jG}rÂ,(jµj¶jL]jK]jI]jJ]jN]ujPM¢jQhj<]rÃ,jZX--hyperlink-sourcerÄ,…rÅ,}rÆ,(jAUjCNjPNjQhjBjÀ,ubaubj³)rÇ,}rÈ,(jAUjBj¸,jCjDjEj¶jG}rÉ,(jµj¶jL]jK]jI]jJ]jN]ujPM¢jQhj<]ubeubjÎ)rÊ,}rË,(jAUjBj³,jCjDjEjÑjG}rÌ,(jI]jJ]jK]jL]jN]ujPM¢jQhj<]rÍ,jq)rÎ,}rÏ,(jAXGenerate Haddock_ documentation integrated with HsColour_ . First, HsColour_ is run to generate colourised code. Then Haddock_ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.jBjÊ,jCjDjEjtjG}rÐ,(jI]jJ]jK]jL]jN]ujPMžjQhj<]rÑ,(jZX Generate rÒ,…rÓ,}rÔ,(jAX Generate jCNjPNjQhjBjÎ,ubj”)rÕ,}rÖ,(jAXHaddock_jàKjBjÎ,jEjjG}r×,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]rØ,jZXHaddockrÙ,…rÚ,}rÛ,(jAUjBjÕ,ubaubjZX documentation integrated with rÜ,…rÝ,}rÞ,(jAX documentation integrated with jCNjPNjQhjBjÎ,ubj”)rß,}rà,(jAX HsColour_jàKjBjÎ,jEjjG}rá,(UnameXHsColourjâX+http://www.cs.york.ac.uk/fp/darcs/hscolour/râ,jL]jK]jI]jJ]jN]uj<]rã,jZXHsColourrä,…rå,}ræ,(jAUjBjß,ubaubjZX . First, rç,…rè,}ré,(jAX . First, jCNjPNjQhjBjÎ,ubj”)rê,}rë,(jAX HsColour_jàKjBjÎ,jEjjG}rì,(UnameXHsColourjâjâ,jL]jK]jI]jJ]jN]uj<]rí,jZXHsColourrî,…rï,}rð,(jAUjBjê,ubaubjZX* is run to generate colourised code. Then rñ,…rò,}ró,(jAX* is run to generate colourised code. Then jCNjPNjQhjBjÎ,ubj”)rô,}rõ,(jAXHaddock_jàKjBjÎ,jEjjG}rö,(UnameXHaddockjâjð*jL]jK]jI]jJ]jN]uj<]r÷,jZXHaddockrø,…rù,}rú,(jAUjBjô,ubaubjZX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.rû,…rü,}rý,(jAX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.jCNjPNjQhjBjÎ,ubeubaubeubjŠ)rþ,}rÿ,(jAUjBjÖ*jCjDjEjjG}r-(jL]jK]jI]jJ]jN]Uentries]r-(jX6setup-haddock command line option; --hscolour-css=pathhõUNtr-aujPNjQhj<]ubj’)r-}r-(jAUjBjÖ*jCjDjEj•jG}r-(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr-j›j-ujPNjQhj<]r-(j)r-}r -(jAX--hscolour-css=pathr -jBj-jCjDjEj jG}r -(j¢]r -X--hscolour-cssr -ajL]r-hõajK]jI]jJ]jN]r-hSaj¨‰ujPM¨jQhj<]r-(jª)r-}r-(jAj -jBj-jCjDjEj­jG}r-(jµj¶jL]jK]jI]jJ]jN]ujPM¨jQhj<]r-jZX--hscolour-cssr-…r-}r-(jAUjCNjPNjQhjBj-ubaubj³)r-}r-(jAX=pathjBj-jCjDjEj¶jG}r-(jµj¶jL]jK]jI]jJ]jN]ujPM¨jQhj<]r-jZX=pathr-…r-}r-(jAUjCNjPNjQhjBj-ubaubeubjÎ)r-}r -(jAUjBj-jCjDjEjÑjG}r!-(jI]jJ]jK]jL]jN]ujPM¨jQhj<]r"-(jq)r#-}r$-(jAXJThe argument *path* denotes a CSS file, which is passed to HsColour_ as inr%-jBj-jCjDjEjtjG}r&-(jI]jJ]jK]jL]jN]ujPM¥jQhj<]r'-(jZX The argument r(-…r)-}r*-(jAX The argument jCNjPNjQhjBj#-ubjµ)r+-}r,-(jAX*path*jG}r--(jI]jJ]jK]jL]jN]ujBj#-j<]r.-jZXpathr/-…r0-}r1-(jAUjBj+-ubajEj½ubjZX( denotes a CSS file, which is passed to r2-…r3-}r4-(jAX( denotes a CSS file, which is passed to jCNjPNjQhjBj#-ubj”)r5-}r6-(jAX HsColour_jàKjBj#-jEjjG}r7-(UnameXHsColourjâjâ,jL]jK]jI]jJ]jN]uj<]r8-jZXHsColourr9-…r:-}r;-(jAUjBj5-ubaubjZX as inr<-…r=-}r>-(jAX as injCNjPNjQhjBj#-ubeubjÇ+)r?-}r@-(jAUjBj-jCjDjEjÊ+jG}rA-(jI]jJ]jK]jL]jN]ujPNjQhj<]rB-jq)rC-}rD-(jAX)runhaskell Setup.hs hscolour --css=*path*rE-jBj?-jCjDjEjtjG}rF-(jI]jJ]jK]jL]jN]ujPM§j<]rG-jZX*runhaskell Setup.hs hscolour –css=*path*rH-…rI-}rJ-(jAjE-jBjC-ubaubaubeubeubjÙ)rK-}rL-(jAX.. _setup-hscolour:jBjÖ*jCjDjEjÜjG}rM-(jL]jK]jI]jJ]jN]jÞj,ujPM©jQhj<]ubeubj>)rN-}rO-(jAUjBjßjCjDjá}rP-hjK-sjEjFjG}rQ-(jI]jJ]jK]jL]rR-(j,jejN]rS-(h|heujPM¬jQhjæ}rT-j,jK-sj<]rU-(jS)rV-}rW-(jAXsetup hscolourrX-jBjN-jCjDjEjWjG}rY-(jI]jJ]jK]jL]jN]ujPM¬jQhj<]rZ-jZXsetup hscolourr[-…r\-}r]-(jAjX-jCNjPNjQhjBjV-ubaubjq)r^-}r_-(jAXProduce colourised code in HTML format using HsColour_. Colourised code for exported modules is put in ``dist/doc/html/``\ *pkgid*\ ``/src``.jBjN-jCjDjEjtjG}r`-(jI]jJ]jK]jL]jN]ujPM®jQhj<]ra-(jZX-Produce colourised code in HTML format using rb-…rc-}rd-(jAX-Produce colourised code in HTML format using jCNjPNjQhjBj^-ubj”)re-}rf-(jAX HsColour_jàKjBj^-jEjjG}rg-(UnameXHsColourjâjâ,jL]jK]jI]jJ]jN]uj<]rh-jZXHsColourri-…rj-}rk-(jAUjBje-ubaubjZX1. Colourised code for exported modules is put in rl-…rm-}rn-(jAX1. Colourised code for exported modules is put in jCNjPNjQhjBj^-ubjz)ro-}rp-(jAX``dist/doc/html/``jG}rq-(jI]jJ]jK]jL]jN]ujBj^-j<]rr-jZXdist/doc/html/rs-…rt-}ru-(jAUjBjo-ubajEj‚ubjZX…rv-}rw-(jAX\ rx-jCNjPNjQhjBj^-ubjµ)ry-}rz-(jAX*pkgid*jG}r{-(jI]jJ]jK]jL]jN]ujBj^-j<]r|-jZXpkgidr}-…r~-}r-(jAUjBjy-ubajEj½ubjZX…r€-}r-(jAjx-jBj^-ubjz)r‚-}rƒ-(jAX``/src``jG}r„-(jI]jJ]jK]jL]jN]ujBj^-j<]r…-jZX/srcr†-…r‡-}rˆ-(jAUjBj‚-ubajEj‚ubjZX.…r‰-}rŠ-(jAX.jCNjPNjQhjBj^-ubeubjq)r‹-}rŒ-(jAX)This command takes the following options:r-jBjN-jCjDjEjtjG}rŽ-(jI]jJ]jK]jL]jN]ujPM±jQhj<]r-jZX)This command takes the following options:r-…r‘-}r’-(jAj-jCNjPNjQhjBj‹-ubaubjŠ)r“-}r”-(jAUjBjN-jCjDjEjjG}r•-(jL]jK]jI]jJ]jN]Uentries]r–-(jX1setup-hscolour command line option; --executablesjUNtr—-aujPNjQhj<]ubj’)r˜-}r™-(jAUjBjN-jCjDjEj•jG}rš-(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr›-j›j›-ujPNjQhj<]rœ-(j)r-}rž-(jAX --executablesrŸ-jBj˜-jCjDjEj jG}r -(j¢]r¡-jŸ-ajL]r¢-jajK]jI]jJ]jN]r£-hraj¨‰ujPM¹jQhj<]r¤-(jª)r¥-}r¦-(jAjŸ-jBj-jCjDjEj­jG}r§-(jµj¶jL]jK]jI]jJ]jN]ujPM¹jQhj<]r¨-jZX --executablesr©-…rª-}r«-(jAUjCNjPNjQhjBj¥-ubaubj³)r¬-}r­-(jAUjBj-jCjDjEj¶jG}r®-(jµj¶jL]jK]jI]jJ]jN]ujPM¹jQhj<]ubeubjÎ)r¯-}r°-(jAUjBj˜-jCjDjEjÑjG}r±-(jI]jJ]jK]jL]jN]ujPM¹jQhj<]r²-jq)r³-}r´-(jAX‹Also run HsColour_ on the sources of all executable programs. Colourised code is put in ``dist/doc/html/``\ *pkgid*/*executable*\ ``/src``.jBj¯-jCjDjEjtjG}rµ-(jI]jJ]jK]jL]jN]ujPM·jQhj<]r¶-(jZX Also run r·-…r¸-}r¹-(jAX Also run jCNjPNjQhjBj³-ubj”)rº-}r»-(jAX HsColour_jàKjBj³-jEjjG}r¼-(UnameXHsColourjâjâ,jL]jK]jI]jJ]jN]uj<]r½-jZXHsColourr¾-…r¿-}rÀ-(jAUjBjº-ubaubjZXF on the sources of all executable programs. Colourised code is put in rÁ-…rÂ-}rÃ-(jAXF on the sources of all executable programs. Colourised code is put in jCNjPNjQhjBj³-ubjz)rÄ-}rÅ-(jAX``dist/doc/html/``jG}rÆ-(jI]jJ]jK]jL]jN]ujBj³-j<]rÇ-jZXdist/doc/html/rÈ-…rÉ-}rÊ-(jAUjBjÄ-ubajEj‚ubjZX…rË-}rÌ-(jAX\ rÍ-jCNjPNjQhjBj³-ubjµ)rÎ-}rÏ-(jAX*pkgid*jG}rÐ-(jI]jJ]jK]jL]jN]ujBj³-j<]rÑ-jZXpkgidrÒ-…rÓ-}rÔ-(jAUjBjÎ-ubajEj½ubjZX/…rÕ-}rÖ-(jAX/jCNjPNjQhjBj³-ubjµ)r×-}rØ-(jAX *executable*jG}rÙ-(jI]jJ]jK]jL]jN]ujBj³-j<]rÚ-jZX executablerÛ-…rÜ-}rÝ-(jAUjBj×-ubajEj½ubjZX…rÞ-}rß-(jAjÍ-jBj³-ubjz)rà-}rá-(jAX``/src``jG}râ-(jI]jJ]jK]jL]jN]ujBj³-j<]rã-jZX/srcrä-…rå-}ræ-(jAUjBjà-ubajEj‚ubjZX.…rç-}rè-(jAX.jCNjPNjQhjBj³-ubeubaubeubjŠ)ré-}rê-(jAUjBjN-jCjDjEjjG}rë-(jL]jK]jI]jJ]jN]Uentries]rì-(jX.setup-hscolour command line option; --css=pathhµUNtrí-aujPNjQhj<]ubj’)rî-}rï-(jAUjBjN-jCjDjEj•jG}rð-(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrñ-j›jñ-ujPNjQhj<]rò-(j)ró-}rô-(jAX --css=pathjBjî-jCjDjEj jG}rõ-(j¢]rö-X--cssr÷-ajL]rø-hµajK]jI]jJ]jN]rù-haj¨‰ujPMÀjQhj<]rú-(jª)rû-}rü-(jAj÷-jBjó-jCjDjEj­jG}rý-(jµj¶jL]jK]jI]jJ]jN]ujPMÀjQhj<]rþ-jZX--cssrÿ-…r.}r.(jAUjCNjPNjQhjBjû-ubaubj³)r.}r.(jAX=pathjBjó-jCjDjEj¶jG}r.(jµj¶jL]jK]jI]jJ]jN]ujPMÀjQhj<]r.jZX=pathr.…r.}r.(jAUjCNjPNjQhjBj.ubaubeubjÎ)r .}r .(jAUjBjî-jCjDjEjÑjG}r .(jI]jJ]jK]jL]jN]ujPMÀjQhj<]r .jq)r .}r.(jAXþUse the given CSS file for the generated HTML files. The CSS file defines the colours used to colourise code. Note that this copies the given CSS file to the directory with the generated HTML files (renamed to ``hscolour.css``) rather than linking to it.jBj .jCjDjEjtjG}r.(jI]jJ]jK]jL]jN]ujPM¼jQhj<]r.(jZXÒUse the given CSS file for the generated HTML files. The CSS file defines the colours used to colourise code. Note that this copies the given CSS file to the directory with the generated HTML files (renamed to r.…r.}r.(jAXÒUse the given CSS file for the generated HTML files. The CSS file defines the colours used to colourise code. Note that this copies the given CSS file to the directory with the generated HTML files (renamed to jCNjPNjQhjBj .ubjz)r.}r.(jAX``hscolour.css``jG}r.(jI]jJ]jK]jL]jN]ujBj .j<]r.jZX hscolour.cssr.…r.}r.(jAUjBj.ubajEj‚ubjZX) rather than linking to it.r.…r.}r.(jAX) rather than linking to it.jCNjPNjQhjBj .ubeubaubeubjÙ)r.}r.(jAX.. _setup-install:jBjN-jCjDjEjÜjG}r .(jL]jK]jI]jJ]jN]jÞhßujPMÁjQhj<]ubeubj>)r!.}r".(jAUjBjßjCjDjá}r#.h`__ are determined by options to `setup configure`_.jBj!.jCjDjEjtjG}r;.(jI]jJ]jK]jL]jN]ujPMÌjQhj<]r<.(jZXThe r=.…r>.}r?.(jAXThe jCNjPNjQhjBj9.ubj”)r@.}rA.(jAX+`install locations <#installation-paths>`__jG}rB.(UnameXinstall locationsjâX#installation-pathsjL]jK]jI]jJ]jN]ujBj9.j<]rC.jZXinstall locationsrD.…rE.}rF.(jAUjBj@.ubajEjubjZX are determined by options to rG.…rH.}rI.(jAX are determined by options to jCNjPNjQhjBj9.ubj”)rJ.}rK.(jAX`setup configure`_jàKjBj9.jEjjG}rL.(UnameXsetup configurejL]jK]jI]jJ]jN]jÞjuj<]rM.jZXsetup configurerN.…rO.}rP.(jAUjBjJ.ubaubjZX.…rQ.}rR.(jAX.jCNjPNjQhjBj9.ubeubjq)rS.}rT.(jAX)This command takes the following options:rU.jBj!.jCjDjEjtjG}rV.(jI]jJ]jK]jL]jN]ujPMÏjQhj<]rW.jZX)This command takes the following options:rX.…rY.}rZ.(jAjU.jCNjPNjQhjBjS.ubaubjŠ)r[.}r\.(jAUjBj!.jCjDjEjjG}r].(jL]jK]jI]jJ]jN]Uentries]r^.(jX+setup-install command line option; --globalhÿUNtr_.aujPNjQhj<]ubj’)r`.}ra.(jAUjBj!.jCjDjEj•jG}rb.(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrc.j›jc.ujPNjQhj<]rd.(j)re.}rf.(jAX--globalrg.jBj`.jCjDjEj jG}rh.(j¢]ri.jg.ajL]rj.hÿajK]jI]jJ]jN]rk.h]aj¨‰ujPMÖjQhj<]rl.(jª)rm.}rn.(jAjg.jBje.jCjDjEj­jG}ro.(jµj¶jL]jK]jI]jJ]jN]ujPMÖjQhj<]rp.jZX--globalrq.…rr.}rs.(jAUjCNjPNjQhjBjm.ubaubj³)rt.}ru.(jAUjBje.jCjDjEj¶jG}rv.(jµj¶jL]jK]jI]jJ]jN]ujPMÖjQhj<]ubeubjÎ)rw.}rx.(jAUjBj`.jCjDjEjÑjG}ry.(jI]jJ]jK]jL]jN]ujPMÖjQhj<]rz.jq)r{.}r|.(jAX§Register this package in the system-wide database. (This is the default, unless the :option:`setup configure --user` option was supplied to the ``configure`` command.)jBjw.jCjDjEjtjG}r}.(jI]jJ]jK]jL]jN]ujPMÓjQhj<]r~.(jZXTRegister this package in the system-wide database. (This is the default, unless the r.…r€.}r.(jAXTRegister this package in the system-wide database. (This is the default, unless the jCNjPNjQhjBj{.ubj¥)r‚.}rƒ.(jAX :option:`setup configure --user`r„.jBj{.jCjDjEj©jG}r….(UreftypeXoptionj«ˆj¬Xsetup configure --userU refdomainXstdr†.jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°X setup-installr‡.ujPMÓj<]rˆ.jz)r‰.}rŠ.(jAj„.jG}r‹.(jI]jJ]rŒ.(j¶j†.X std-optionr.ejK]jL]jN]ujBj‚.j<]rŽ.jZXsetup configure --userr.…r.}r‘.(jAUjBj‰.ubajEj‚ubaubjZX option was supplied to the r’.…r“.}r”.(jAX option was supplied to the jCNjPNjQhjBj{.ubjz)r•.}r–.(jAX ``configure``jG}r—.(jI]jJ]jK]jL]jN]ujBj{.j<]r˜.jZX configurer™.…rš.}r›.(jAUjBj•.ubajEj‚ubjZX command.)rœ.…r.}rž.(jAX command.)jCNjPNjQhjBj{.ubeubaubeubjŠ)rŸ.}r .(jAUjBj!.jCjDjEjjG}r¡.(jL]jK]jI]jJ]jN]Uentries]r¢.(jX)setup-install command line option; --userj UNtr£.aujPNjQhj<]ubj’)r¤.}r¥.(jAUjBj!.jCjDjEj•jG}r¦.(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr§.j›j§.ujPNjQhj<]r¨.(j)r©.}rª.(jAX--userr«.jBj¤.jCjDjEj jG}r¬.(j¢]r­.j«.ajL]r®.j ajK]jI]jJ]jN]r¯.hiaj¨‰ujPMÜjQhj<]r°.(jª)r±.}r².(jAj«.jBj©.jCjDjEj­jG}r³.(jµj¶jL]jK]jI]jJ]jN]ujPMÜjQhj<]r´.jZX--userrµ.…r¶.}r·.(jAUjCNjPNjQhjBj±.ubaubj³)r¸.}r¹.(jAUjBj©.jCjDjEj¶jG}rº.(jµj¶jL]jK]jI]jJ]jN]ujPMÜjQhj<]ubeubjÎ)r».}r¼.(jAUjBj¤.jCjDjEjÑjG}r½.(jI]jJ]jK]jL]jN]ujPMÜjQhj<]r¾.jq)r¿.}rÀ.(jAX«Register this package in the user's local package database. (This is the default if the :option:`setup configure --user` option was supplied to the ``configure`` command.)jBj».jCjDjEjtjG}rÁ.(jI]jJ]jK]jL]jN]ujPMÙjQhj<]rÂ.(jZXZRegister this package in the user’s local package database. (This is the default if the rÃ.…rÄ.}rÅ.(jAXXRegister this package in the user's local package database. (This is the default if the jCNjPNjQhjBj¿.ubj¥)rÆ.}rÇ.(jAX :option:`setup configure --user`rÈ.jBj¿.jCjDjEj©jG}rÉ.(UreftypeXoptionj«ˆj¬Xsetup configure --userU refdomainXstdrÊ.jL]jK]U refexplicit‰jI]jJ]jN]j®j¯j°j‡.ujPMÙj<]rË.jz)rÌ.}rÍ.(jAjÈ.jG}rÎ.(jI]jJ]rÏ.(j¶jÊ.X std-optionrÐ.ejK]jL]jN]ujBjÆ.j<]rÑ.jZXsetup configure --userrÒ.…rÓ.}rÔ.(jAUjBjÌ.ubajEj‚ubaubjZX option was supplied to the rÕ.…rÖ.}r×.(jAX option was supplied to the jCNjPNjQhjBj¿.ubjz)rØ.}rÙ.(jAX ``configure``jG}rÚ.(jI]jJ]jK]jL]jN]ujBj¿.j<]rÛ.jZX configurerÜ.…rÝ.}rÞ.(jAUjBjØ.ubajEj‚ubjZX command.)rß.…rà.}rá.(jAX command.)jCNjPNjQhjBj¿.ubeubaubeubjÙ)râ.}rã.(jAX.. _setup-copy:jBj!.jCjDjEjÜjG}rä.(jL]jK]jI]jJ]jN]jÞj8ujPMÝjQhj<]ubeubj>)rå.}ræ.(jAUjBjßjCjDjá}rç.hœjâ.sjEjFjG}rè.(jI]jJ]jK]jL]ré.(j8j#ejN]rê.(h†hœeujPMàjQhjæ}rë.j8jâ.sj<]rì.(jS)rí.}rî.(jAX setup copyrï.jBjå.jCjDjEjWjG}rð.(jI]jJ]jK]jL]jN]ujPMàjQhj<]rñ.jZX setup copyrò.…ró.}rô.(jAjï.jCNjPNjQhjBjí.ubaubjq)rõ.}rö.(jAXiCopy the files without registering them. This command is mainly of use to those creating binary packages.r÷.jBjå.jCjDjEjtjG}rø.(jI]jJ]jK]jL]jN]ujPMâjQhj<]rù.jZXiCopy the files without registering them. This command is mainly of use to those creating binary packages.rú.…rû.}rü.(jAj÷.jCNjPNjQhjBjõ.ubaubjq)rý.}rþ.(jAX(This command takes the following option:rÿ.jBjå.jCjDjEjtjG}r/(jI]jJ]jK]jL]jN]ujPMåjQhj<]r/jZX(This command takes the following option:r/…r/}r/(jAjÿ.jCNjPNjQhjBjý.ubaubjŠ)r/}r/(jAUjBjå.jCjDjEjjG}r/(jL]jK]jI]jJ]jN]Uentries]r/(jX.setup-copy command line option; --destdir=pathhéUNtr /aujPNjQhj<]ubj’)r /}r /(jAUjBjå.jCjDjEj•jG}r /(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr /j›j /ujPNjQhj<]r/(j)r/}r/(jAX--destdir=pathjBj /jCjDjEj jG}r/(j¢]r/X --destdirr/ajL]r/héajK]jI]jJ]jN]r/hGaj¨‰ujPMíjQhj<]r/(jª)r/}r/(jAj/jBj/jCjDjEj­jG}r/(jµj¶jL]jK]jI]jJ]jN]ujPMíjQhj<]r/jZX --destdirr/…r/}r/(jAUjCNjPNjQhjBj/ubaubj³)r/}r/(jAX=pathjBj/jCjDjEj¶jG}r /(jµj¶jL]jK]jI]jJ]jN]ujPMíjQhj<]r!/jZX=pathr"/…r#/}r$/(jAUjCNjPNjQhjBj/ubaubeubjÎ)r%/}r&/(jAUjBj /jCjDjEjÑjG}r'/(jI]jJ]jK]jL]jN]ujPMíjQhj<]r(/jq)r)/}r*/(jAXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r+/jBj%/jCjDjEjtjG}r,/(jI]jJ]jK]jL]jN]ujPMëjQhj<]r-/jZXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r./…r//}r0/(jAj+/jCNjPNjQhjBj)/ubaubaubeubjÙ)r1/}r2/(jAX.. _setup-register:jBjå.jCjDjEjÜjG}r3/(jL]jK]jI]jJ]jN]jÞhýujPMîjQhj<]ubeubj>)r4/}r5/(jAUjBjßjCjDjá}r6/h[j1/sjEjFjG}r7/(jI]jJ]jK]jL]r8/(hýhÅejN]r9/(h"h[eujPMñjQhjæ}r:/hýj1/sj<]r;/(jS)r/jBj4/jCjDjEjWjG}r?/(jI]jJ]jK]jL]jN]ujPMñjQhj<]r@/jZXsetup registerrA/…rB/}rC/(jAj>/jCNjPNjQhjBj0jZXÝThis option outputs a directory if the package requires multiple registrations: this can occur if internal/convenience libraries are used. These configuration file names are sorted so that they can be registered in order.r?0…r@0}rA0(jAj<0jCNjPNjQhjBj:0ubaubeubeubjŠ)rB0}rC0(jAUjBj4/jCjDjEjjG}rD0(jL]jK]jI]jJ]jN]Uentries]rE0(jX-setup-register command line option; --inplacejUNtrF0aujPNjQhj<]ubj’)rG0}rH0(jAUjBj4/jCjDjEj•jG}rI0(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrJ0j›jJ0ujPNjQhj<]rK0(j)rL0}rM0(jAX --inplacerN0jBjG0jCjDjEj jG}rO0(j¢]rP0jN0ajL]rQ0jajK]jI]jJ]jN]rR0hqaj¨‰ujPM.jQhj<]rS0(jª)rT0}rU0(jAjN0jBjL0jCjDjEj­jG}rV0(jµj¶jL]jK]jI]jJ]jN]ujPM.jQhj<]rW0jZX --inplacerX0…rY0}rZ0(jAUjCNjPNjQhjBjT0ubaubj³)r[0}r\0(jAUjBjL0jCjDjEj¶jG}r]0(jµj¶jL]jK]jI]jJ]jN]ujPM.jQhj<]ubeubjÎ)r^0}r_0(jAUjBjG0jCjDjEjÑjG}r`0(jI]jJ]jK]jL]jN]ujPM.jQhj<]ra0(jq)rb0}rc0(jAXÎRegisters the package for use directly from the build tree, without needing to install it. This can be useful for testing: there's no need to install the package after modifying it, just recompile and test.rd0jBj^0jCjDjEjtjG}re0(jI]jJ]jK]jL]jN]ujPM"jQhj<]rf0jZXÐRegisters the package for use directly from the build tree, without needing to install it. This can be useful for testing: there’s no need to install the package after modifying it, just recompile and test.rg0…rh0}ri0(jAjd0jCNjPNjQhjBjb0ubaubjq)rj0}rk0(jAX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.rl0jBj^0jCjDjEjtjG}rm0(jI]jJ]jK]jL]jN]ujPM'jQhj<]rn0jZX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.ro0…rp0}rq0(jAjl0jCNjPNjQhjBjj0ubaubjq)rr0}rs0(jAXÈHowever, there are some caveats. It only works with GHC (currently). It only works if your package doesn't depend on having any supplemental files installed --- plain Haskell libraries should be fine.rt0jBj^0jCjDjEjtjG}ru0(jI]jJ]jK]jL]jN]ujPM*jQhj<]rv0jZXÊHowever, there are some caveats. It only works with GHC (currently). It only works if your package doesn’t depend on having any supplemental files installed — plain Haskell libraries should be fine.rw0…rx0}ry0(jAjt0jCNjPNjQhjBjr0ubaubeubeubjÙ)rz0}r{0(jAX.. _setup-unregister:jBj4/jCjDjEjÜjG}r|0(jL]jK]jI]jJ]jN]jÞh«ujPM/jQhj<]ubeubj>)r}0}r~0(jAUjBjßjCjDjá}r0hjz0sjEjFjG}r€0(jI]jJ]jK]jL]r0(h«j$ejN]r‚0(h‡heujPM2jQhjæ}rƒ0h«jz0sj<]r„0(jS)r…0}r†0(jAXsetup unregisterr‡0jBj}0jCjDjEjWjG}rˆ0(jI]jJ]jK]jL]jN]ujPM2jQhj<]r‰0jZXsetup unregisterrŠ0…r‹0}rŒ0(jAj‡0jCNjPNjQhjBj…0ubaubjq)r0}rŽ0(jAX*Deregister this package with the compiler.r0jBj}0jCjDjEjtjG}r0(jI]jJ]jK]jL]jN]ujPM6jQhj<]r‘0jZX*Deregister this package with the compiler.r’0…r“0}r”0(jAj0jCNjPNjQhjBj0ubaubjq)r•0}r–0(jAX)This command takes the following options:r—0jBj}0jCjDjEjtjG}r˜0(jI]jJ]jK]jL]jN]ujPM8jQhj<]r™0jZX)This command takes the following options:rš0…r›0}rœ0(jAj—0jCNjPNjQhjBj•0ubaubjŠ)r0}rž0(jAUjBj}0jCjDjEjjG}rŸ0(jL]jK]jI]jJ]jN]Uentries]r 0(jX.setup-unregister command line option; --globalhúUNtr¡0aujPNjQhj<]ubj’)r¢0}r£0(jAUjBj}0jCjDjEj•jG}r¤0(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¥0j›j¥0ujPNjQhj<]r¦0(j)r§0}r¨0(jAX--globalr©0jBj¢0jCjDjEj jG}rª0(j¢]r«0j©0ajL]r¬0húajK]jI]jJ]jN]r­0hXaj¨‰ujPM>jQhj<]r®0(jª)r¯0}r°0(jAj©0jBj§0jCjDjEj­jG}r±0(jµj¶jL]jK]jI]jJ]jN]ujPM>jQhj<]r²0jZX--globalr³0…r´0}rµ0(jAUjCNjPNjQhjBj¯0ubaubj³)r¶0}r·0(jAUjBj§0jCjDjEj¶jG}r¸0(jµj¶jL]jK]jI]jJ]jN]ujPM>jQhj<]ubeubjÎ)r¹0}rº0(jAUjBj¢0jCjDjEjÑjG}r»0(jI]jJ]jK]jL]jN]ujPM>jQhj<]r¼0jq)r½0}r¾0(jAXKDeregister this package in the system-wide database. (This is the default.)r¿0jBj¹0jCjDjEjtjG}rÀ0(jI]jJ]jK]jL]jN]ujPM<jQhj<]rÁ0jZXKDeregister this package in the system-wide database. (This is the default.)rÂ0…rÃ0}rÄ0(jAj¿0jCNjPNjQhjBj½0ubaubaubeubjŠ)rÅ0}rÆ0(jAUjBj}0jCjDjEjjG}rÇ0(jL]jK]jI]jJ]jN]Uentries]rÈ0(jX,setup-unregister command line option; --userh¹UNtrÉ0aujPNjQhj<]ubj’)rÊ0}rË0(jAUjBj}0jCjDjEj•jG}rÌ0(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÍ0j›jÍ0ujPNjQhj<]rÎ0(j)rÏ0}rÐ0(jAX--userrÑ0jBjÊ0jCjDjEj jG}rÒ0(j¢]rÓ0jÑ0ajL]rÔ0h¹ajK]jI]jJ]jN]rÕ0haj¨‰ujPMBjQhj<]rÖ0(jª)r×0}rØ0(jAjÑ0jBjÏ0jCjDjEj­jG}rÙ0(jµj¶jL]jK]jI]jJ]jN]ujPMBjQhj<]rÚ0jZX--userrÛ0…rÜ0}rÝ0(jAUjCNjPNjQhjBj×0ubaubj³)rÞ0}rß0(jAUjBjÏ0jCjDjEj¶jG}rà0(jµj¶jL]jK]jI]jJ]jN]ujPMBjQhj<]ubeubjÎ)rá0}râ0(jAUjBjÊ0jCjDjEjÑjG}rã0(jI]jJ]jK]jL]jN]ujPMBjQhj<]rä0jq)rå0}ræ0(jAX=Deregister this package in the user's local package database.rç0jBjá0jCjDjEjtjG}rè0(jI]jJ]jK]jL]jN]ujPMAjQhj<]ré0jZX?Deregister this package in the user’s local package database.rê0…rë0}rì0(jAjç0jCNjPNjQhjBjå0ubaubaubeubjŠ)rí0}rî0(jAUjBj}0jCjDjEjjG}rï0(jL]jK]jI]jJ]jN]Uentries]rð0(jX2setup-unregister command line option; --gen-scripthâUNtrñ0aujPNjQhj<]ubj’)rò0}ró0(jAUjBj}0jCjDjEj•jG}rô0(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrõ0j›jõ0ujPNjQhj<]rö0(j)r÷0}rø0(jAX --gen-scriptrù0jBjò0jCjDjEj jG}rú0(j¢]rû0jù0ajL]rü0hâajK]jI]jJ]jN]rý0h?aj¨‰ujPMIjQhj<]rþ0(jª)rÿ0}r1(jAjù0jBj÷0jCjDjEj­jG}r1(jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]r1jZX --gen-scriptr1…r1}r1(jAUjCNjPNjQhjBjÿ0ubaubj³)r1}r1(jAUjBj÷0jCjDjEj¶jG}r1(jµj¶jL]jK]jI]jJ]jN]ujPMIjQhj<]ubeubjÎ)r 1}r 1(jAUjBjò0jCjDjEjÑjG}r 1(jI]jJ]jK]jL]jN]ujPMIjQhj<]r 1jq)r 1}r1(jAX Instead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called ``unregister.sh``, on Windows, ``unregister.bat``. This script might be included in a binary bundle, to be run on the target system.jBj 1jCjDjEjtjG}r1(jI]jJ]jK]jL]jN]ujPMEjQhj<]r1(jZXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called r1…r1}r1(jAXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called jCNjPNjQhjBj 1ubjz)r1}r1(jAX``unregister.sh``jG}r1(jI]jJ]jK]jL]jN]ujBj 1j<]r1jZX unregister.shr1…r1}r1(jAUjBj1ubajEj‚ubjZX, on Windows, r1…r1}r1(jAX, on Windows, jCNjPNjQhjBj 1ubjz)r1}r1(jAX``unregister.bat``jG}r 1(jI]jJ]jK]jL]jN]ujBj 1j<]r!1jZXunregister.batr"1…r#1}r$1(jAUjBj1ubajEj‚ubjZXS. This script might be included in a binary bundle, to be run on the target system.r%1…r&1}r'1(jAXS. This script might be included in a binary bundle, to be run on the target system.jCNjPNjQhjBj 1ubeubaubeubjÙ)r(1}r)1(jAX.. _setup-clean:jBj}0jCjDjEjÜjG}r*1(jL]jK]jI]jJ]jN]jÞh¯ujPMJjQhj<]ubeubj>)r+1}r,1(jAUjBjßjCjDjá}r-1h j(1sjEjFjG}r.1(jI]jJ]jK]jL]r/1(h¯j+ejN]r01(hh eujPMMjQhjæ}r11h¯j(1sj<]r21(jS)r31}r41(jAX setup cleanr51jBj+1jCjDjEjWjG}r61(jI]jJ]jK]jL]jN]ujPMMjQhj<]r71jZX setup cleanr81…r91}r:1(jAj51jCNjPNjQhjBj31ubaubjq)r;1}r<1(jAXËRemove any local files created during the ``configure``, ``build``, ``haddock``, ``register`` or ``unregister`` steps, and also any files and directories listed in the :pkg-field:`extra-tmp-files` field.jBj+1jCjDjEjtjG}r=1(jI]jJ]jK]jL]jN]ujPMOjQhj<]r>1(jZX*Remove any local files created during the r?1…r@1}rA1(jAX*Remove any local files created during the jCNjPNjQhjBj;1ubjz)rB1}rC1(jAX ``configure``jG}rD1(jI]jJ]jK]jL]jN]ujBj;1j<]rE1jZX configurerF1…rG1}rH1(jAUjBjB1ubajEj‚ubjZX, rI1…rJ1}rK1(jAX, rL1jCNjPNjQhjBj;1ubjz)rM1}rN1(jAX ``build``jG}rO1(jI]jJ]jK]jL]jN]ujBj;1j<]rP1jZXbuildrQ1…rR1}rS1(jAUjBjM1ubajEj‚ubjZX, rT1…rU1}rV1(jAX, jCNjPNjQhjBj;1ubjz)rW1}rX1(jAX ``haddock``jG}rY1(jI]jJ]jK]jL]jN]ujBj;1j<]rZ1jZXhaddockr[1…r\1}r]1(jAUjBjW1ubajEj‚ubjZX, r^1…r_1}r`1(jAjL1jBj;1ubjz)ra1}rb1(jAX ``register``jG}rc1(jI]jJ]jK]jL]jN]ujBj;1j<]rd1jZXregisterre1…rf1}rg1(jAUjBja1ubajEj‚ubjZX or rh1…ri1}rj1(jAX or jCNjPNjQhjBj;1ubjz)rk1}rl1(jAX``unregister``jG}rm1(jI]jJ]jK]jL]jN]ujBj;1j<]rn1jZX unregisterro1…rp1}rq1(jAUjBjk1ubajEj‚ubjZX9 steps, and also any files and directories listed in the rr1…rs1}rt1(jAX9 steps, and also any files and directories listed in the jCNjPNjQhjBj;1ubj¥)ru1}rv1(jAX:pkg-field:`extra-tmp-files`rw1jBj;1jCjDjEj©jG}rx1(UreftypeX pkg-fieldj«ˆj¬Xextra-tmp-filesU refdomainXcabalry1jL]jK]U refexplicit‰jI]jJ]jN]j®j¯Ucabal:pkg-sectionrz1NujPMOj<]r{1jz)r|1}r}1(jAjw1jG}r~1(jI]jJ]r1(j¶jy1Xcabal-pkg-fieldr€1ejK]jL]jN]ujBju1j<]r1jZXextra-tmp-filesr‚1…rƒ1}r„1(jAUjBj|1ubajEj‚ubaubjZX field.r…1…r†1}r‡1(jAX field.jCNjPNjQhjBj;1ubeubjq)rˆ1}r‰1(jAX)This command takes the following options:rŠ1jBj+1jCjDjEjtjG}r‹1(jI]jJ]jK]jL]jN]ujPMSjQhj<]rŒ1jZX)This command takes the following options:r1…rŽ1}r1(jAjŠ1jCNjPNjQhjBjˆ1ubaubjŠ)r1}r‘1(jAUjBj+1jCjDjEjjG}r’1(jL]jK]jI]jJ]jN]Uentries]r“1(jX5setup-clean command line option; --save-configure, -shÂUNtr”1aujPNjQhj<]ubj’)r•1}r–1(jAUjBj+1jCjDjEj•jG}r—1(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr˜1j›j˜1ujPNjQhj<]r™1(j)rš1}r›1(jAX--save-configure, -sjBj•1jCjDjEj jG}rœ1(j¢]r1(X--save-configurerž1X-srŸ1ejL]r 1hÂajK]jI]jJ]jN]r¡1(hghej¨‰ujPM[jQhj<]r¢1(jª)r£1}r¤1(jAjž1jBjš1jCjDjEj­jG}r¥1(jµj¶jL]jK]jI]jJ]jN]ujPM[jQhj<]r¦1jZX--save-configurer§1…r¨1}r©1(jAUjCNjPNjQhjBj£1ubaubj³)rª1}r«1(jAUjBjš1jCjDjEj¶jG}r¬1(jµj¶jL]jK]jI]jJ]jN]ujPM[jQhj<]ubj³)r­1}r®1(jAjºjBjš1jCjDjEj¶jG}r¯1(jµj¶jL]jK]jI]jJ]jN]ujPM[jQhj<]r°1jZX, r±1…r²1}r³1(jAUjCNjPNjQhjBj­1ubaubjª)r´1}rµ1(jAjŸ1jBjš1jCjDjEj­jG}r¶1(jµj¶jL]jK]jI]jJ]jN]ujPM[jQhj<]r·1jZX-sr¸1…r¹1}rº1(jAUjCNjPNjQhjBj´1ubaubj³)r»1}r¼1(jAUjBjš1jCjDjEj¶jG}r½1(jµj¶jL]jK]jI]jJ]jN]ujPM[jQhj<]ubeubjÎ)r¾1}r¿1(jAUjBj•1jCjDjEjÑjG}rÀ1(jI]jJ]jK]jL]jN]ujPM[jQhj<]rÁ1jq)rÂ1}rÃ1(jAXkKeeps the configuration information so it is not necessary to run the configure step again before building.rÄ1jBj¾1jCjDjEjtjG}rÅ1(jI]jJ]jK]jL]jN]ujPMYjQhj<]rÆ1jZXkKeeps the configuration information so it is not necessary to run the configure step again before building.rÇ1…rÈ1}rÉ1(jAjÄ1jCNjPNjQhjBjÂ1ubaubaubeubeubj>)rÊ1}rË1(jAUjBjßjCjDjEjFjG}rÌ1(jI]jJ]jK]jL]rÍ1h÷ajN]rÎ1hUaujPM]jQhj<]rÏ1(jS)rÐ1}rÑ1(jAX setup testrÒ1jBjÊ1jCjDjEjWjG}rÓ1(jI]jJ]jK]jL]jN]ujPM]jQhj<]rÔ1jZX setup testrÕ1…rÖ1}r×1(jAjÒ1jCNjPNjQhjBjÐ1ubaubjq)rØ1}rÙ1(jAX(Run the test suites specified in the package description file. Aside from the following flags, Cabal accepts the name of one or more test suites on the command line after ``test``. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.jBjÊ1jCjDjEjtjG}rÚ1(jI]jJ]jK]jL]jN]ujPM_jQhj<]rÛ1(jZX«Run the test suites specified in the package description file. Aside from the following flags, Cabal accepts the name of one or more test suites on the command line after rÜ1…rÝ1}rÞ1(jAX«Run the test suites specified in the package description file. Aside from the following flags, Cabal accepts the name of one or more test suites on the command line after jCNjPNjQhjBjØ1ubjz)rß1}rà1(jAX``test``jG}rá1(jI]jJ]jK]jL]jN]ujBjØ1j<]râ1jZXtestrã1…rä1}rå1(jAUjBjß1ubajEj‚ubjZXu. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.ræ1…rç1}rè1(jAXu. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.jCNjPNjQhjBjØ1ubeubjŠ)ré1}rê1(jAUjBjÊ1jCjDjEjjG}rë1(jL]jK]jI]jJ]jN]Uentries]rì1(jX.setup-test command line option; --builddir=dirhëUNtrí1aujPNjQhj<]ubj’)rî1}rï1(jAUjBjÊ1jCjDjEj•jG}rð1(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionrñ1j›jñ1ujPNjQhj<]rò1(j)ró1}rô1(jAX--builddir=dirjBjî1jCjDjEj jG}rõ1(j¢]rö1X --builddirr÷1ajL]rø1hëajK]jI]jJ]jN]rù1hIaj¨‰ujPMkjQhj<]rú1(jª)rû1}rü1(jAj÷1jBjó1jCjDjEj­jG}rý1(jµj¶jL]jK]jI]jJ]jN]ujPMkjQhj<]rþ1jZX --builddirrÿ1…r2}r2(jAUjCNjPNjQhjBjû1ubaubj³)r2}r2(jAX=dirjBjó1jCjDjEj¶jG}r2(jµj¶jL]jK]jI]jJ]jN]ujPMkjQhj<]r2jZX=dirr2…r2}r2(jAUjCNjPNjQhjBj2ubaubeubjÎ)r 2}r 2(jAUjBjî1jCjDjEjÑjG}r 2(jI]jJ]jK]jL]jN]ujPMkjQhj<]r 2jq)r 2}r2(jAXThe directory where Cabal puts generated build files (default: ``dist``). Test logs will be located in the ``test`` subdirectory.jBj 2jCjDjEjtjG}r2(jI]jJ]jK]jL]jN]ujPMijQhj<]r2(jZX?The directory where Cabal puts generated build files (default: r2…r2}r2(jAX?The directory where Cabal puts generated build files (default: jCNjPNjQhjBj 2ubjz)r2}r2(jAX``dist``jG}r2(jI]jJ]jK]jL]jN]ujBj 2j<]r2jZXdistr2…r2}r2(jAUjBj2ubajEj‚ubjZX$). Test logs will be located in the r2…r2}r2(jAX$). Test logs will be located in the jCNjPNjQhjBj 2ubjz)r2}r2(jAX``test``jG}r 2(jI]jJ]jK]jL]jN]ujBj 2j<]r!2jZXtestr"2…r#2}r$2(jAUjBj2ubajEj‚ubjZX subdirectory.r%2…r&2}r'2(jAX subdirectory.jCNjPNjQhjBj 2ubeubaubeubjŠ)r(2}r)2(jAUjBjÊ1jCjDjEjjG}r*2(jL]jK]jI]jJ]jN]Uentries]r+2(jX0setup-test command line option; --human-log=pathh®UNtr,2aujPNjQhj<]ubj’)r-2}r.2(jAUjBjÊ1jCjDjEj•jG}r/2(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr02j›j02ujPNjQhj<]r12(j)r22}r32(jAX--human-log=pathjBj-2jCjDjEj jG}r42(j¢]r52X --human-logr62ajL]r72h®ajK]jI]jJ]jN]r82h aj¨‰ujPMtjQhj<]r92(jª)r:2}r;2(jAj62jBj22jCjDjEj­jG}r<2(jµj¶jL]jK]jI]jJ]jN]ujPMtjQhj<]r=2jZX --human-logr>2…r?2}r@2(jAUjCNjPNjQhjBj:2ubaubj³)rA2}rB2(jAX=pathjBj22jCjDjEj¶jG}rC2(jµj¶jL]jK]jI]jJ]jN]ujPMtjQhj<]rD2jZX=pathrE2…rF2}rG2(jAUjCNjPNjQhjBjA2ubaubeubjÎ)rH2}rI2(jAUjBj-2jCjDjEjÑjG}rJ2(jI]jJ]jK]jL]jN]ujPMtjQhj<]rK2jq)rL2}rM2(jAX~The template used to name human-readable test logs; the path is relative to ``dist/test``. By default, logs are named according to the template ``$pkgid-$test-suite.log``, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: ``$pkgid``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``, ``$test-suite``, and ``$result``.jBjH2jCjDjEjtjG}rN2(jI]jJ]jK]jL]jN]ujPMnjQhj<]rO2(jZXLThe template used to name human-readable test logs; the path is relative to rP2…rQ2}rR2(jAXLThe template used to name human-readable test logs; the path is relative to jCNjPNjQhjBjL2ubjz)rS2}rT2(jAX ``dist/test``jG}rU2(jI]jJ]jK]jL]jN]ujBjL2j<]rV2jZX dist/testrW2…rX2}rY2(jAUjBjS2ubajEj‚ubjZX7. By default, logs are named according to the template rZ2…r[2}r\2(jAX7. By default, logs are named according to the template jCNjPNjQhjBjL2ubjz)r]2}r^2(jAX``$pkgid-$test-suite.log``jG}r_2(jI]jJ]jK]jL]jN]ujBjL2j<]r`2jZX$pkgid-$test-suite.logra2…rb2}rc2(jAUjBj]2ubajEj‚ubjZXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: rd2…re2}rf2(jAXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: jCNjPNjQhjBjL2ubjz)rg2}rh2(jAX ``$pkgid``jG}ri2(jI]jJ]jK]jL]jN]ujBjL2j<]rj2jZX$pkgidrk2…rl2}rm2(jAUjBjg2ubajEj‚ubjZX, rn2…ro2}rp2(jAX, rq2jCNjPNjQhjBjL2ubjz)rr2}rs2(jAX ``$compiler``jG}rt2(jI]jJ]jK]jL]jN]ujBjL2j<]ru2jZX $compilerrv2…rw2}rx2(jAUjBjr2ubajEj‚ubjZX, ry2…rz2}r{2(jAX, jBjL2ubjz)r|2}r}2(jAX``$os``jG}r~2(jI]jJ]jK]jL]jN]ujBjL2j<]r2jZX$osr€2…r2}r‚2(jAUjBj|2ubajEj‚ubjZX, rƒ2…r„2}r…2(jAX, jCNjPNjQhjBjL2ubjz)r†2}r‡2(jAX ``$arch``jG}rˆ2(jI]jJ]jK]jL]jN]ujBjL2j<]r‰2jZX$archrŠ2…r‹2}rŒ2(jAUjBj†2ubajEj‚ubjZX, r2…rŽ2}r2(jAX, jBjL2ubjz)r2}r‘2(jAX``$abi``jG}r’2(jI]jJ]jK]jL]jN]ujBjL2j<]r“2jZX$abir”2…r•2}r–2(jAUjBj2ubajEj‚ubjZX, r—2…r˜2}r™2(jAX, jBjL2ubjz)rš2}r›2(jAX ``$abitag``jG}rœ2(jI]jJ]jK]jL]jN]ujBjL2j<]r2jZX$abitagrž2…rŸ2}r 2(jAUjBjš2ubajEj‚ubjZX, r¡2…r¢2}r£2(jAjq2jBjL2ubjz)r¤2}r¥2(jAX``$test-suite``jG}r¦2(jI]jJ]jK]jL]jN]ujBjL2j<]r§2jZX $test-suiter¨2…r©2}rª2(jAUjBj¤2ubajEj‚ubjZX, and r«2…r¬2}r­2(jAX, and jCNjPNjQhjBjL2ubjz)r®2}r¯2(jAX ``$result``jG}r°2(jI]jJ]jK]jL]jN]ujBjL2j<]r±2jZX$resultr²2…r³2}r´2(jAUjBj®2ubajEj‚ubjZX.…rµ2}r¶2(jAX.jCNjPNjQhjBjL2ubeubaubeubjŠ)r·2}r¸2(jAUjBjÊ1jCjDjEjjG}r¹2(jL]jK]jI]jJ]jN]Uentries]rº2(jX2setup-test command line option; --machine-log=pathhÌUNtr»2aujPNjQhj<]ubj’)r¼2}r½2(jAUjBjÊ1jCjDjEj•jG}r¾2(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr¿2j›j¿2ujPNjQhj<]rÀ2(j)rÁ2}rÂ2(jAX--machine-log=pathjBj¼2jCjDjEj jG}rÃ2(j¢]rÄ2X --machine-logrÅ2ajL]rÆ2hÌajK]jI]jJ]jN]rÇ2h)aj¨‰ujPM{jQhj<]rÈ2(jª)rÉ2}rÊ2(jAjÅ2jBjÁ2jCjDjEj­jG}rË2(jµj¶jL]jK]jI]jJ]jN]ujPM{jQhj<]rÌ2jZX --machine-logrÍ2…rÎ2}rÏ2(jAUjCNjPNjQhjBjÉ2ubaubj³)rÐ2}rÑ2(jAX=pathjBjÁ2jCjDjEj¶jG}rÒ2(jµj¶jL]jK]jI]jJ]jN]ujPM{jQhj<]rÓ2jZX=pathrÔ2…rÕ2}rÖ2(jAUjCNjPNjQhjBjÐ2ubaubeubjÎ)r×2}rØ2(jAUjBj¼2jCjDjEjÑjG}rÙ2(jI]jJ]jK]jL]jN]ujPM{jQhj<]rÚ2jq)rÛ2}rÜ2(jAXÞThe path to the machine-readable log, relative to ``dist/test``. The default template is ``$pkgid.log``. Template variables allowed are: ``$pkgid``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag`` and ``$result``.jBj×2jCjDjEjtjG}rÝ2(jI]jJ]jK]jL]jN]ujPMwjQhj<]rÞ2(jZX2The path to the machine-readable log, relative to rß2…rà2}rá2(jAX2The path to the machine-readable log, relative to jCNjPNjQhjBjÛ2ubjz)râ2}rã2(jAX ``dist/test``jG}rä2(jI]jJ]jK]jL]jN]ujBjÛ2j<]rå2jZX dist/testræ2…rç2}rè2(jAUjBjâ2ubajEj‚ubjZX. The default template is ré2…rê2}rë2(jAX. The default template is jCNjPNjQhjBjÛ2ubjz)rì2}rí2(jAX``$pkgid.log``jG}rî2(jI]jJ]jK]jL]jN]ujBjÛ2j<]rï2jZX $pkgid.logrð2…rñ2}rò2(jAUjBjì2ubajEj‚ubjZX". Template variables allowed are: ró2…rô2}rõ2(jAX". Template variables allowed are: jCNjPNjQhjBjÛ2ubjz)rö2}r÷2(jAX ``$pkgid``jG}rø2(jI]jJ]jK]jL]jN]ujBjÛ2j<]rù2jZX$pkgidrú2…rû2}rü2(jAUjBjö2ubajEj‚ubjZX, rý2…rþ2}rÿ2(jAX, r3jCNjPNjQhjBjÛ2ubjz)r3}r3(jAX ``$compiler``jG}r3(jI]jJ]jK]jL]jN]ujBjÛ2j<]r3jZX $compilerr3…r3}r3(jAUjBj3ubajEj‚ubjZX, r3…r 3}r 3(jAX, jBjÛ2ubjz)r 3}r 3(jAX``$os``jG}r 3(jI]jJ]jK]jL]jN]ujBjÛ2j<]r3jZX$osr3…r3}r3(jAUjBj 3ubajEj‚ubjZX, r3…r3}r3(jAX, jBjÛ2ubjz)r3}r3(jAX ``$arch``jG}r3(jI]jJ]jK]jL]jN]ujBjÛ2j<]r3jZX$archr3…r3}r3(jAUjBj3ubajEj‚ubjZX, r3…r3}r3(jAX, jBjÛ2ubjz)r3}r 3(jAX``$abi``jG}r!3(jI]jJ]jK]jL]jN]ujBjÛ2j<]r"3jZX$abir#3…r$3}r%3(jAUjBj3ubajEj‚ubjZX, r&3…r'3}r(3(jAj3jBjÛ2ubjz)r)3}r*3(jAX ``$abitag``jG}r+3(jI]jJ]jK]jL]jN]ujBjÛ2j<]r,3jZX$abitagr-3…r.3}r/3(jAUjBj)3ubajEj‚ubjZX and r03…r13}r23(jAX and jCNjPNjQhjBjÛ2ubjz)r33}r43(jAX ``$result``jG}r53(jI]jJ]jK]jL]jN]ujBjÛ2j<]r63jZX$resultr73…r83}r93(jAUjBj33ubajEj‚ubjZX.…r:3}r;3(jAX.jCNjPNjQhjBjÛ2ubeubaubeubjŠ)r<3}r=3(jAUjBjÊ1jCjDjEjjG}r>3(jL]jK]jI]jJ]jN]Uentries]r?3(jX5setup-test command line option; --show-details=filterhîUNtr@3aujPNjQhj<]ubj’)rA3}rB3(jAUjBjÊ1jCjDjEj•jG}rC3(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrD3j›jD3ujPNjQhj<]rE3(j)rF3}rG3(jAX--show-details=filterjBjA3jCjDjEj jG}rH3(j¢]rI3X--show-detailsrJ3ajL]rK3hîajK]jI]jJ]jN]rL3hLaj¨‰ujPM‚jQhj<]rM3(jª)rN3}rO3(jAjJ3jBjF3jCjDjEj­jG}rP3(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]rQ3jZX--show-detailsrR3…rS3}rT3(jAUjCNjPNjQhjBjN3ubaubj³)rU3}rV3(jAX=filterjBjF3jCjDjEj¶jG}rW3(jµj¶jL]jK]jI]jJ]jN]ujPM‚jQhj<]rX3jZX=filterrY3…rZ3}r[3(jAUjCNjPNjQhjBjU3ubaubeubjÎ)r\3}r]3(jAUjBjA3jCjDjEjÑjG}r^3(jI]jJ]jK]jL]jN]ujPM‚jQhj<]r_3jq)r`3}ra3(jAXáDetermines if the results of individual test cases are shown on the terminal. May be ``always`` (always show), ``never`` (never show), ``failures`` (show only failed results), or ``streaming`` (show all results in real time).jBj\3jCjDjEjtjG}rb3(jI]jJ]jK]jL]jN]ujPM~jQhj<]rc3(jZXUDetermines if the results of individual test cases are shown on the terminal. May be rd3…re3}rf3(jAXUDetermines if the results of individual test cases are shown on the terminal. May be jCNjPNjQhjBj`3ubjz)rg3}rh3(jAX ``always``jG}ri3(jI]jJ]jK]jL]jN]ujBj`3j<]rj3jZXalwaysrk3…rl3}rm3(jAUjBjg3ubajEj‚ubjZX (always show), rn3…ro3}rp3(jAX (always show), jCNjPNjQhjBj`3ubjz)rq3}rr3(jAX ``never``jG}rs3(jI]jJ]jK]jL]jN]ujBj`3j<]rt3jZXneverru3…rv3}rw3(jAUjBjq3ubajEj‚ubjZX (never show), rx3…ry3}rz3(jAX (never show), jCNjPNjQhjBj`3ubjz)r{3}r|3(jAX ``failures``jG}r}3(jI]jJ]jK]jL]jN]ujBj`3j<]r~3jZXfailuresr3…r€3}r3(jAUjBj{3ubajEj‚ubjZX (show only failed results), or r‚3…rƒ3}r„3(jAX (show only failed results), or jCNjPNjQhjBj`3ubjz)r…3}r†3(jAX ``streaming``jG}r‡3(jI]jJ]jK]jL]jN]ujBj`3j<]rˆ3jZX streamingr‰3…rŠ3}r‹3(jAUjBj…3ubajEj‚ubjZX! (show all results in real time).rŒ3…r3}rŽ3(jAX! (show all results in real time).jCNjPNjQhjBj`3ubeubaubeubjŠ)r3}r3(jAUjBjÊ1jCNjEjjG}r‘3(jL]jK]jI]jJ]jN]Uentries]r’3((jX6setup-test command line option; --test-options=optionsh¿UNtr“3(jXKsetup-test command line option; Give extra options to the test executables.j5UNtr”3eujPNjQhj<]ubj’)r•3}r–3(jAUjBjÊ1jCNjEj•jG}r—3(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr˜3j›j˜3ujPNjQhj<]r™3(j)rš3}r›3(jAX--test-options=optionsjBj•3jCjDjEj jG}rœ3(j¢]r3X--test-optionsrž3ajL]rŸ3h¿ajK]jI]jJ]jN]r 3haj¨‰ujPM…jQhj<]r¡3(jª)r¢3}r£3(jAjž3jBjš3jCjDjEj­jG}r¤3(jµj¶jL]jK]jI]jJ]jN]ujPM…jQhj<]r¥3jZX--test-optionsr¦3…r§3}r¨3(jAUjCNjPNjQhjBj¢3ubaubj³)r©3}rª3(jAX=optionsjBjš3jCjDjEj¶jG}r«3(jµj¶jL]jK]jI]jJ]jN]ujPM…jQhj<]r¬3jZX=optionsr­3…r®3}r¯3(jAUjCNjPNjQhjBj©3ubaubeubj)r°3}r±3(jAX+Give extra options to the test executables.jBj•3jCjDjEj jG}r²3(j¢]r³3XGiver´3ajL]rµ3j5ajK]jI]jJ]jN]r¶3h™aj¨‰ujPM…jQhj<]r·3(jª)r¸3}r¹3(jAj´3jBj°3jCjDjEj­jG}rº3(jµj¶jL]jK]jI]jJ]jN]ujPM…jQhj<]r»3jZXGiver¼3…r½3}r¾3(jAUjCNjPNjQhjBj¸3ubaubj³)r¿3}rÀ3(jAX' extra options to the test executables.jBj°3jCjDjEj¶jG}rÁ3(jµj¶jL]jK]jI]jJ]jN]ujPM…jQhj<]rÂ3jZX' extra options to the test executables.rÃ3…rÄ3}rÅ3(jAUjCNjPNjQhjBj¿3ubaubeubjÎ)rÆ3}rÇ3(jAUjBj•3jCjDjEjÑjG}rÈ3(jI]jJ]jK]jL]jN]ujPM…jQhj<]ubeubjŠ)rÉ3}rÊ3(jAUjBjÊ1jCjDjEjjG}rË3(jL]jK]jI]jJ]jN]Uentries]rÌ3(jX4setup-test command line option; --test-option=optionh³UNtrÍ3aujPNjQhj<]ubj’)rÎ3}rÏ3(jAUjBjÊ1jCjDjEj•jG}rÐ3(j—‰j˜XstdjL]jK]jI]jJ]jN]j™XoptionrÑ3j›jÑ3ujPNjQhj<]rÒ3(j)rÓ3}rÔ3(jAX--test-option=optionjBjÎ3jCjDjEj jG}rÕ3(j¢]rÖ3X --test-optionr×3ajL]rØ3h³ajK]jI]jJ]jN]rÙ3haj¨‰ujPM‹jQhj<]rÚ3(jª)rÛ3}rÜ3(jAj×3jBjÓ3jCjDjEj­jG}rÝ3(jµj¶jL]jK]jI]jJ]jN]ujPM‹jQhj<]rÞ3jZX --test-optionrß3…rà3}rá3(jAUjCNjPNjQhjBjÛ3ubaubj³)râ3}rã3(jAX=optionjBjÓ3jCjDjEj¶jG}rä3(jµj¶jL]jK]jI]jJ]jN]ujPM‹jQhj<]rå3jZX=optionræ3…rç3}rè3(jAUjCNjPNjQhjBjâ3ubaubeubjÎ)ré3}rê3(jAUjBjÎ3jCjDjEjÑjG}rë3(jI]jJ]jK]jL]jN]ujPM‹jQhj<]rì3jq)rí3}rî3(jAX­give an extra option to the test executables. There is no need to quote options containing spaces because a single option is assumed, so options will not be split on spaces.rï3jBjé3jCjDjEjtjG}rð3(jI]jJ]jK]jL]jN]ujPMˆjQhj<]rñ3jZX­give an extra option to the test executables. There is no need to quote options containing spaces because a single option is assumed, so options will not be split on spaces.rò3…ró3}rô3(jAjï3jCNjPNjQhjBjí3ubaubaubeubjÙ)rõ3}rö3(jAX.. _setup-sdist:jBjÊ1jCjDjEjÜjG}r÷3(jL]jK]jI]jJ]jN]jÞhãujPMŒjQhj<]ubeubj>)rø3}rù3(jAUjBjßjCjDjá}rú3h@jõ3sjEjFjG}rû3(jI]jJ]jK]jL]rü3(hãj7ejN]rý3(h›h@eujPMjQhjæ}rþ3hãjõ3sj<]rÿ3(jS)r4}r4(jAX setup sdistr4jBjø3jCjDjEjWjG}r4(jI]jJ]jK]jL]jN]ujPMjQhj<]r4jZX setup sdistr4…r4}r4(jAj4jCNjPNjQhjBj4ubaubjq)r4}r 4(jAXòCreate a system- and compiler-independent source distribution in a file *package*-*version*\ ``.tar.gz`` in the ``dist`` subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.jBjø3jCjDjEjtjG}r 4(jI]jJ]jK]jL]jN]ujPM‘jQhj<]r 4(jZXHCreate a system- and compiler-independent source distribution in a file r 4…r 4}r4(jAXHCreate a system- and compiler-independent source distribution in a file jCNjPNjQhjBj4ubjµ)r4}r4(jAX *package*jG}r4(jI]jJ]jK]jL]jN]ujBj4j<]r4jZXpackager4…r4}r4(jAUjBj4ubajEj½ubjZX-…r4}r4(jAX-jCNjPNjQhjBj4ubjµ)r4}r4(jAX *version*jG}r4(jI]jJ]jK]jL]jN]ujBj4j<]r4jZXversionr4…r4}r4(jAUjBj4ubajEj½ubjZX…r4}r 4(jAX\ jCNjPNjQhjBj4ubjz)r!4}r"4(jAX ``.tar.gz``jG}r#4(jI]jJ]jK]jL]jN]ujBj4j<]r$4jZX.tar.gzr%4…r&4}r'4(jAUjBj!4ubajEj‚ubjZX in the r(4…r)4}r*4(jAX in the jCNjPNjQhjBj4ubjz)r+4}r,4(jAX``dist``jG}r-4(jI]jJ]jK]jL]jN]ujBj4j<]r.4jZXdistr/4…r04}r14(jAUjBj+4ubajEj‚ubjZXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.r24…r34}r44(jAXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.jCNjPNjQhjBj4ubeubjq)r54}r64(jAX7The files placed in this distribution are the package description file, the setup script, the sources of the modules named in the package description file, and files named in the ``license-file``, ``main-is``, ``c-sources``, ``js-sources``, ``data-files``, ``extra-source-files`` and ``extra-doc-files`` fields.jBjø3jCjDjEjtjG}r74(jI]jJ]jK]jL]jN]ujPM–jQhj<]r84(jZX³The files placed in this distribution are the package description file, the setup script, the sources of the modules named in the package description file, and files named in the r94…r:4}r;4(jAX³The files placed in this distribution are the package description file, the setup script, the sources of the modules named in the package description file, and files named in the jCNjPNjQhjBj54ubjz)r<4}r=4(jAX``license-file``jG}r>4(jI]jJ]jK]jL]jN]ujBj54j<]r?4jZX license-filer@4…rA4}rB4(jAUjBj<4ubajEj‚ubjZX, rC4…rD4}rE4(jAX, rF4jCNjPNjQhjBj54ubjz)rG4}rH4(jAX ``main-is``jG}rI4(jI]jJ]jK]jL]jN]ujBj54j<]rJ4jZXmain-isrK4…rL4}rM4(jAUjBjG4ubajEj‚ubjZX, rN4…rO4}rP4(jAX, jCNjPNjQhjBj54ubjz)rQ4}rR4(jAX ``c-sources``jG}rS4(jI]jJ]jK]jL]jN]ujBj54j<]rT4jZX c-sourcesrU4…rV4}rW4(jAUjBjQ4ubajEj‚ubjZX, rX4…rY4}rZ4(jAX, jBj54ubjz)r[4}r\4(jAX``js-sources``jG}r]4(jI]jJ]jK]jL]jN]ujBj54j<]r^4jZX js-sourcesr_4…r`4}ra4(jAUjBj[4ubajEj‚ubjZX, rb4…rc4}rd4(jAX, jBj54ubjz)re4}rf4(jAX``data-files``jG}rg4(jI]jJ]jK]jL]jN]ujBj54j<]rh4jZX data-filesri4…rj4}rk4(jAUjBje4ubajEj‚ubjZX, rl4…rm4}rn4(jAjF4jBj54ubjz)ro4}rp4(jAX``extra-source-files``jG}rq4(jI]jJ]jK]jL]jN]ujBj54j<]rr4jZXextra-source-filesrs4…rt4}ru4(jAUjBjo4ubajEj‚ubjZX and rv4…rw4}rx4(jAX and jCNjPNjQhjBj54ubjz)ry4}rz4(jAX``extra-doc-files``jG}r{4(jI]jJ]jK]jL]jN]ujBj54j<]r|4jZXextra-doc-filesr}4…r~4}r4(jAUjBjy4ubajEj‚ubjZX fields.r€4…r4}r‚4(jAX fields.jCNjPNjQhjBj54ubeubjq)rƒ4}r„4(jAX(This command takes the following option:r…4jBjø3jCjDjEjtjG}r†4(jI]jJ]jK]jL]jN]ujPMœjQhj<]r‡4jZX(This command takes the following option:rˆ4…r‰4}rŠ4(jAj…4jCNjPNjQhjBjƒ4ubaubjŠ)r‹4}rŒ4(jAUjBjø3jCjDjEjjG}r4(jL]jK]jI]jJ]jN]Uentries]rŽ4(jX+setup-sdist command line option; --snapshothËUNtr4aujPNjQhj<]ubj’)r4}r‘4(jAUjBjø3jCjDjEj•jG}r’4(j—‰j˜XstdjL]jK]jI]jJ]jN]j™Xoptionr“4j›j“4ujPNjQhj<]r”4(j)r•4}r–4(jAX --snapshotr—4jBj4jCjDjEj jG}r˜4(j¢]r™4j—4ajL]rš4hËajK]jI]jJ]jN]r›4h(aj¨‰ujPM¥jQhj<]rœ4(jª)r4}rž4(jAj—4jBj•4jCjDjEj­jG}rŸ4(jµj¶jL]jK]jI]jJ]jN]ujPM¥jQhj<]r 4jZX --snapshotr¡4…r¢4}r£4(jAUjCNjPNjQhjBj4ubaubj³)r¤4}r¥4(jAUjBj•4jCjDjEj¶jG}r¦4(jµj¶jL]jK]jI]jJ]jN]ujPM¥jQhj<]ubeubjÎ)r§4}r¨4(jAUjBj4jCjDjEjÑjG}r©4(jI]jJ]jK]jL]jN]ujPM¥jQhj<]rª4jq)r«4}r¬4(jAX†Append today's date (in "YYYYMMDD" format) to the version number for the generated source package. The original package is unaffected.r­4jBj§4jCjDjEjtjG}r®4(jI]jJ]jK]jL]jN]ujPM¢jQhj<]r¯4jZXŒAppend today’s date (in “YYYYMMDD†format) to the version number for the generated source package. The original package is unaffected.r°4…r±4}r²4(jAj­4jCNjPNjQhjBj«4ubaubaubeubj)*)r³4}r´4(jAX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyjBjø3jCcdocutils.nodes reprunicode rµ4Xdoc/references.incr¶4…r·4}r¸4bjEj,*jG}r¹4(jµj¶jL]jK]jI]jJ]jN]ujPKjQhj<]rº4jZX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyr»4…r¼4}r½4(jAUjBj³4ubaubjÙ)r¾4}r¿4(jAX .. _`Package Versioning Policy`:jBjø3jCj·4jEjÜjG}rÀ4(jL]jK]jI]jJ]jN]jÞj ujPM¬jQhj<]ubjÙ)rÁ4}rÂ4(jAX .. _PVP: http://pvp.haskell.org/jBjø3jCj·4já}rÃ4hƒj¾4sjEjÜjG}rÄ4(jâXhttp://pvp.haskell.org/jL]rÅ4(híj ejK]jI]jJ]jN]rÆ4(hKhƒeujPM­jQhjæ}rÇ4j j¾4sj<]ubjÙ)rÈ4}rÉ4(jAX(.. _Hackage: http://hackage.haskell.org/j^KjBjø3jCj·4jEjÜjG}rÊ4(jâjãjL]rË4j;ajK]jI]jJ]jN]rÌ4hŸaujPM¯jQhj<]ubjÙ)rÍ4}rÎ4(jAX$.. _Haskell: http://www.haskell.org/jBjø3jCj·4jEjÜjG}rÏ4(jâXhttp://www.haskell.org/jL]rÐ4jajK]jI]jJ]jN]rÑ4h^aujPM±jQhj<]ubjÙ)rÒ4}rÓ4(jAX,.. _Haddock: http://www.haskell.org/haddock/j^KjBjø3jCj·4jEjÜjG}rÔ4(jâjð*jL]rÕ4jajK]jI]jJ]jN]rÖ4hyaujPM³jQhj<]ubjÙ)r×4}rØ4(jAX&.. _Alex: http://www.haskell.org/alex/jBjø3jCj·4jEjÜjG}rÙ4(jâXhttp://www.haskell.org/alex/jL]rÚ4hïajK]jI]jJ]jN]rÛ4hMaujPMµjQhj<]ubjÙ)rÜ4}rÝ4(jAX(.. _Happy: http://www.haskell.org/happy/jBjø3jCj·4jEjÜjG}rÞ4(jâXhttp://www.haskell.org/happy/jL]rß4j ajK]jI]jJ]jN]rà4hkaujPM·jQhj<]ubjÙ)rá4}râ4(jAX*.. _Hoogle: http://www.haskell.org/hoogle/j^KjBjø3jCj·4jEjÜjG}rã4(jâjl+jL]rä4jajK]jI]jJ]jN]rå4h`aujPM¹jQhj<]ubjÙ)ræ4}rç4(jAX9.. _HsColour: http://www.cs.york.ac.uk/fp/darcs/hscolour/j^KjBjø3jCj·4jEjÜjG}rè4(jâjâ,jL]ré4hÞajK]jI]jJ]jN]rê4h;aujPM»jQhj<]ubjÙ)rë4}rì4(jAX-.. _cpphs: http://projects.haskell.org/cpphs/jBjø3jCj·4jEjÜjG}rí4(jâX"http://projects.haskell.org/cpphs/jL]rî4hóajK]jI]jJ]jN]rï4hQaujPM½jQhj<]ubeubeubejAUU transformerrð4NU footnote_refsrñ4}rò4Urefnamesró4}rô4(Xhaddock]rõ4(jí*jt+j,j ,jQ,j[,jš,j¤,jÕ,jô,eXhscolour]rö4(jß,jê,j5-je-jº-eXsetup configure]r÷4jJ.aXhoogle]rø4ji+aXhackage]rù4(jÞjùj}j½+euUsymbol_footnotesrú4]rû4Uautofootnote_refsrü4]rý4Usymbol_footnote_refsrþ4]rÿ4U citationsr5]r5jQhU current_liner5NUtransform_messagesr5]r5(cdocutils.nodes system_message r5)r5}r5(jAUjG}r5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineK•UtypeUINFOr 5uj<]r 5jq)r 5}r 5(jAUjG}r 5(jI]jJ]jK]jL]jN]ujBj5j<]r5jZX9Hyperlink target "installing-packages" is not referenced.r5…r5}r5(jAUjBj 5ubajEjtubajEUsystem_messager5ubj5)r5}r5(jAUjG}r5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineM¾Utypej 5uj<]r5jq)r5}r5(jAUjG}r5(jI]jJ]jK]jL]jN]ujBj5j<]r5jZX5Hyperlink target "setup-configure" is not referenced.r5…r5}r5(jAUjBj5ubajEjtubajEj5ubj5)r5}r5(jAUjG}r 5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMOUtypej 5uj<]r!5jq)r"5}r#5(jAUjG}r$5(jI]jJ]jK]jL]jN]ujBj5j<]r%5jZX1Hyperlink target "setup-build" is not referenced.r&5…r'5}r(5(jAUjBj"5ubajEjtubajEj5ubj5)r)5}r*5(jAUjG}r+5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMdUtypej 5uj<]r,5jq)r-5}r.5(jAUjG}r/5(jI]jJ]jK]jL]jN]ujBj)5j<]r05jZX3Hyperlink target "setup-haddock" is not referenced.r15…r25}r35(jAUjBj-5ubajEjtubajEj5ubj5)r45}r55(jAUjG}r65(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineM©Utypej 5uj<]r75jq)r85}r95(jAUjG}r:5(jI]jJ]jK]jL]jN]ujBj45j<]r;5jZX4Hyperlink target "setup-hscolour" is not referenced.r<5…r=5}r>5(jAUjBj85ubajEjtubajEj5ubj5)r?5}r@5(jAUjG}rA5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMÁUtypej 5uj<]rB5jq)rC5}rD5(jAUjG}rE5(jI]jJ]jK]jL]jN]ujBj?5j<]rF5jZX3Hyperlink target "setup-install" is not referenced.rG5…rH5}rI5(jAUjBjC5ubajEjtubajEj5ubj5)rJ5}rK5(jAUjG}rL5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMÝUtypej 5uj<]rM5jq)rN5}rO5(jAUjG}rP5(jI]jJ]jK]jL]jN]ujBjJ5j<]rQ5jZX0Hyperlink target "setup-copy" is not referenced.rR5…rS5}rT5(jAUjBjN5ubajEjtubajEj5ubj5)rU5}rV5(jAUjG}rW5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMîUtypej 5uj<]rX5jq)rY5}rZ5(jAUjG}r[5(jI]jJ]jK]jL]jN]ujBjU5j<]r\5jZX4Hyperlink target "setup-register" is not referenced.r]5…r^5}r_5(jAUjBjY5ubajEjtubajEj5ubj5)r`5}ra5(jAUjG}rb5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineM/Utypej 5uj<]rc5jq)rd5}re5(jAUjG}rf5(jI]jJ]jK]jL]jN]ujBj`5j<]rg5jZX6Hyperlink target "setup-unregister" is not referenced.rh5…ri5}rj5(jAUjBjd5ubajEjtubajEj5ubj5)rk5}rl5(jAUjG}rm5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMJUtypej 5uj<]rn5jq)ro5}rp5(jAUjG}rq5(jI]jJ]jK]jL]jN]ujBjk5j<]rr5jZX1Hyperlink target "setup-clean" is not referenced.rs5…rt5}ru5(jAUjBjo5ubajEjtubajEj5ubj5)rv5}rw5(jAUjG}rx5(jI]UlevelKjL]jK]UsourcejDjJ]jN]UlineMŒUtypej 5uj<]ry5jq)rz5}r{5(jAUjG}r|5(jI]jJ]jK]jL]jN]ujBjv5j<]r}5jZX1Hyperlink target "setup-sdist" is not referenced.r~5…r5}r€5(jAUjBjz5ubajEjtubajEj5ubj5)r5}r‚5(jAUjG}rƒ5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineM¬Utypej 5uj<]r„5jq)r…5}r†5(jAUjG}r‡5(jI]jJ]jK]jL]jN]ujBj5j<]rˆ5jZX?Hyperlink target "package-versioning-policy" is not referenced.r‰5…rŠ5}r‹5(jAUjBj…5ubajEjtubajEj5ubj5)rŒ5}r5(jAUjG}rŽ5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineM­Utypej 5uj<]r5jq)r5}r‘5(jAUjG}r’5(jI]jJ]jK]jL]jN]ujBjŒ5j<]r“5jZX)Hyperlink target "pvp" is not referenced.r”5…r•5}r–5(jAUjBj5ubajEjtubajEj5ubj5)r—5}r˜5(jAUjG}r™5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineM±Utypej 5uj<]rš5jq)r›5}rœ5(jAUjG}r5(jI]jJ]jK]jL]jN]ujBj—5j<]rž5jZX-Hyperlink target "haskell" is not referenced.rŸ5…r 5}r¡5(jAUjBj›5ubajEjtubajEj5ubj5)r¢5}r£5(jAUjG}r¤5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineMµUtypej 5uj<]r¥5jq)r¦5}r§5(jAUjG}r¨5(jI]jJ]jK]jL]jN]ujBj¢5j<]r©5jZX*Hyperlink target "alex" is not referenced.rª5…r«5}r¬5(jAUjBj¦5ubajEjtubajEj5ubj5)r­5}r®5(jAUjG}r¯5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineM·Utypej 5uj<]r°5jq)r±5}r²5(jAUjG}r³5(jI]jJ]jK]jL]jN]ujBj­5j<]r´5jZX+Hyperlink target "happy" is not referenced.rµ5…r¶5}r·5(jAUjBj±5ubajEjtubajEj5ubj5)r¸5}r¹5(jAUjG}rº5(jI]UlevelKjL]jK]Usourcej·4jJ]jN]UlineM½Utypej 5uj<]r»5jq)r¼5}r½5(jAUjG}r¾5(jI]jJ]jK]jL]jN]ujBj¸5j<]r¿5jZX+Hyperlink target "cpphs" is not referenced.rÀ5…rÁ5}rÂ5(jAUjBj¼5ubajEjtubajEj5ubeUreporterrÃ5NUid_startrÄ5K U autofootnotesrÅ5]rÆ5U citation_refsrÇ5}rÈ5Uindirect_targetsrÉ5]rÊ5UsettingsrË5(cdocutils.frontend Values rÌ5orÍ5}rÎ5(Ufootnote_backlinksrÏ5KUrecord_dependenciesrÐ5NU language_coderÑ5UenrÒ5U tracebackrÓ5ˆUpep_referencesrÔ5NUstrip_commentsrÕ5NU toc_backlinksrÖ5j‘U rfc_base_urlr×5Uhttps://tools.ietf.org/html/rØ5U datestamprÙ5NU report_levelrÚ5KUsmartquotes_localesrÛ5NU _destinationrÜ5NU halt_levelrÝ5KU strip_classesrÞ5NjWNUerror_encoding_error_handlerrß5Ubackslashreplacerà5Udebugrá5NUembed_stylesheetrâ5‰Uoutput_encoding_error_handlerrã5Ustricträ5U sectnum_xformrå5KUdump_transformsræ5NU docinfo_xformrç5KUwarning_streamrè5NUpep_file_url_templateré5Upep-%04drê5Uexit_status_levelrë5KUconfigrì5NUstrict_visitorrí5NUcloak_email_addressesrî5ˆUtrim_footnote_reference_spacerï5‰Uenvrð5NUdump_pseudo_xmlrñ5NUexpose_internalsrò5NUsectsubtitle_xformró5‰U source_linkrô5NUrfc_referencesrõ5NUoutput_encodingrö5Uutf-8r÷5U source_urlrø5NUinput_encodingrù5U utf-8-sigrú5U_disable_configrû5NU id_prefixrü5UUcharacter_level_inline_markuprý5‰U tab_widthrþ5KUerror_encodingrÿ5UUTF-8r6U_sourcer6jDUgettext_compactr6ˆU generatorr6NUdump_internalsr6NU smart_quotesr6ˆU pep_base_urlr6U https://www.python.org/dev/peps/r6Usyntax_highlightr6Ulongr 6Uinput_encoding_error_handlerr 6jä5Uauto_id_prefixr 6Uidr 6Udoctitle_xformr 6‰Ustrip_elements_with_classesr6NU _config_filesr6]Ufile_insertion_enabledr6ˆU raw_enabledr6KU dump_settingsr6NubUsymbol_footnote_startr6KUidsr6}r6(hÚj#(hÑj<hìj¿#j)jÖ*h«j}0hÎjJh¯j+1hÓjµ h°jÖ*hÜjj6j5'hËj•4j j| j*j„%h½jÁ$hÀj_)j1j«j5j°3jjRjj·/h»jA"hÃjh*hïj×4h¸jßhÆj¿!j9jæjj¿jjìhúj§0híjÁ4j(j° h²j’*hÖjdjj høj!hÝj&hÌjÁ2hÞjæ4hßj!.j j@!jj/hãjø3j$j}0hºj'j#jå.héj/jjN-håj!.j3jh*hÐj—jj\j%jêj jÁ4j j©.hójë4h×j~hÈj‰h¹jÏ0h·j`$háj† h÷jÊ1hÙj/+hÔjêjj8j/jù+hàjžhâj÷0jjf jjlj!jg/hèjo,jj'$hûjchçjÔ%hýj4/hõj-hôj®&jjá4hÒj4,hæj—!höjG&hñj?h¬j¦ j_jZjjL0j7jø3hµjó-j'jØ'h¼j2hÿje.h´jÄj"j¬%j jÜ4jjÔh­jÓhÏj'h³jÓ3jjü%hªj™$jj\hîjF3hëjó1jjÒ4hØj¡j&jjjÍ4hÛj©"h¶j¢hüj"hÂjš1hÄj“h®j22hÉji hùjò/jjÑ"hþjí hðjhÁjé$jj-j,jN-hÍj!jjIjj’+jjXj.jßhÕj¯jj¸,h¿jš3j0j¶j jhêjC*j2jæhÊj 'h¾jghòjK%jjj-j h±j°j+j+1hÇj häjCjjo&j8jå.h©jÌ hÅj4/j:jßj;jÈ4j4j%uUsubstitution_namesr6}r6jEjQjG}r6(jI]jL]jK]UsourcejDjJ]jN]uU footnotesr6]r6Urefidsr6}r6(h°]r6jÓ*aj]r6jYahã]r6jõ3aj.]r 6jÚaj ]r!6j¾4ahý]r"6j1/ah«]r#6jz0aj8]r$6jâ.ah¯]r%6j(1ahÃ]r&6je*ahß]r'6j.aj,]r(6jK-auub.