€cdocutils.nodes document q)q}q(U nametypesq}q(Xcmdoption-setup-configure--cidqˆX1cmdoption-setup-configure--disable-response-filesqˆ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--internalq0ˆX!cmdoption-setup-configure--bindirq1ˆX$cmdoption-setup-configure--dynlibdirq2ˆX"cmdoption-setup-configure--htmldirq3ˆX"cmdoption-setup-configure--datadirq4ˆX)cmdoption-setup-configure--program-prefixq5ˆX)path variables in the simple build systemq6NXcmdoption-setup-haddock--hoogleq7ˆX'cmdoption-setup-configure--allow-newer[q8ˆX4cmdoption-setup-configure--disable-library-profilingq9ˆXrepository specificationq:NXprefix-independenceq;NXhscolourq<ˆX setup-installq=ˆXcmdoption-setup-hq>ˆXprograms used for buildingq?NX&cmdoption-setup-unregister--gen-scriptq@ˆX setup-sdistqAˆXcmdoption-setup-configure--uhcqBˆX paths in the simple build systemqCNX setup installqDNX/cmdoption-setup-configure--disable-optimizationqEˆX)cmdoption-setup-configure--disable-sharedqFˆXcmdoption-setup-haddock--cssqGˆXcmdoption-setup-copy--destdirqHˆX%cmdoption-setup-configure--preferenceqIˆXcmdoption-setup-test--builddirqJˆX4cmdoption-setup-configure--library-profiling-detail[qKˆXpvpqLˆX"cmdoption-setup-test--show-detailsqMˆXalexqNˆXcmdoption-setup-configure--userqOˆX configurationqPNX6cmdoption-setup-configure--enable-executable-strippingqQˆXcpphsqRˆX.cmdoption-setup-configure--extra-include-dirs[qSˆX%cmdoption-setup-haddock--hscolour-cssqTˆX5cmdoption-setup-configure--disable-executable-dynamicqUˆX setup testqVNX*cmdoption-setup-configure--enable-coverageqWˆX)cmdoption-setup-register--gen-pkg-config[qXˆX"cmdoption-setup-unregister--globalqYˆXoverviewqZNX,cmdoption-setup-configure--disable-profilingq[ˆXsetup-registerq\ˆXinstallation pathsq]NXcmdoption-setup-install--globalq^ˆXhaskellq_ˆX%cmdoption-setup-configure--datasubdirq`ˆXhoogleqaˆXcmdoption-setup-configure--ipidqbˆX%cmdoption-setup-configure--package-dbqcˆX setup cleanqdNX+cmdoption-setup-configure--configure-optionqeˆXabnfqfˆX1cmdoption-setup-configure--enable-library-vanillaqgˆX,cmdoption-setup-configure--profiling-detail[qhˆXusing secure repositoriesqiNX%cmdoption-setup-clean--save-configureqjˆX&cmdoption-setup-configure--prog-optionqkˆXcmdoption-setup-install--userqlˆXdeveloping with sandboxesqmNXhappyqnˆX)cmdoption-setup-configure--disable-staticqoˆX/cmdoption-setup-configure--enable-optimization[qpˆX(building and installing a system packageqqNXcmdoption-setup-register--userqrˆX cmdoption-setup-configure--flagsqsˆX#cmdoption-setup-build--prog-optionsqtˆX!cmdoption-setup-register--inplacequˆX%cmdoption-setup-hscolour--executablesqvˆXsetup-configureqwˆX'cmdoption-setup-configure--prog-optionsqxˆXcmdoption-setup-configure--lhcqyˆX%cmdoption-setup-configure--sysconfdirqzˆX+cmdoption-setup-configure--disable-coverageq{ˆX$cmdoption-setup-configure--libsubdirq|ˆXhaddockq}ˆX&cmdoption-setup-haddock--html-locationq~ˆX4cmdoption-setup-configure--enable-executable-dynamicqˆXsetup hscolourq€NX installing packages from hackageqNX'cmdoption-setup-configure--allow-older[q‚ˆXcmdoption-setup-configure--jhcqƒˆX)cmdoption-setup-haddock--hyperlink-sourceq„ˆXsetup configureq…NX$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 haddockq‘NX7cmdoption-setup-configure--disable-executable-strippingq’ˆX(cmdoption-setup-configure--enable-staticq“ˆXsetup-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­hU0cmdoption-setup-configure-disable-response-filesq®hU1cmdoption-setup-configure-enable-library-for-ghciq¯h Usetup-unregisterq°h Ucmdoption-setup-configure-ghcq±h Usandboxes-advanced-usageq²h Ucmdoption-setup-test-human-logq³h U setup-cleanq´hU 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Æh U$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Öh0U cmdoption-setup-haddock-internalq×h1U cmdoption-setup-configure-bindirqØh2U#cmdoption-setup-configure-dynlibdirqÙh3U!cmdoption-setup-configure-htmldirqÚh4U!cmdoption-setup-configure-datadirqÛh5U(cmdoption-setup-configure-program-prefixqÜh6U)path-variables-in-the-simple-build-systemqÝh7Ucmdoption-setup-haddock-hoogleqÞh8U%cmdoption-setup-configure-allow-newerqßh9U3cmdoption-setup-configure-disable-library-profilingqàh:Urepository-specificationqáh;Uprefix-independenceqâhUcmdoption-setup-helpqåh?Uprograms-used-for-buildingqæh@U%cmdoption-setup-unregister-gen-scriptqçhAU setup-sdistqèhBh±hCU paths-in-the-simple-build-systemqéhDUid5qêhEU.cmdoption-setup-configure-disable-optimizationqëhFU(cmdoption-setup-configure-disable-sharedqìhGUcmdoption-setup-haddock-cssqíhHUcmdoption-setup-copy-destdirqîhIU$cmdoption-setup-configure-preferenceqïhJUcmdoption-setup-test-builddirqðhKU2cmdoption-setup-configure-library-profiling-detailqñhLUpvpqòhMU!cmdoption-setup-test-show-detailsqóhNUalexqôhOUcmdoption-setup-configure-userqõhPU configurationqöhQU5cmdoption-setup-configure-enable-executable-strippingq÷hRUcpphsqøhSU,cmdoption-setup-configure-extra-include-dirsqùhTU$cmdoption-setup-haddock-hscolour-cssqúhUU4cmdoption-setup-configure-disable-executable-dynamicqûhVU setup-testqühWU)cmdoption-setup-configure-enable-coverageqýhXU'cmdoption-setup-register-gen-pkg-configqþhYU!cmdoption-setup-unregister-globalqÿhZUoverviewrh[U+cmdoption-setup-configure-disable-profilingrh\Usetup-registerrh]Uinstallation-pathsrh^Ucmdoption-setup-install-globalrh_Uhaskellrh`U$cmdoption-setup-configure-datasubdirrhaUhooglerhbUcmdoption-setup-configure-ipidrhcU$cmdoption-setup-configure-package-dbr hdUid9r heU*cmdoption-setup-configure-configure-optionr hfUabnfr hgU0cmdoption-setup-configure-enable-library-vanillar hhU*cmdoption-setup-configure-profiling-detailrhiUusing-secure-repositoriesrhjhÇhkU%cmdoption-setup-configure-prog-optionrhlUcmdoption-setup-install-userrhmUdeveloping-with-sandboxesrhnUhappyrhoU(cmdoption-setup-configure-disable-staticrhpU-cmdoption-setup-configure-enable-optimizationrhqU(building-and-installing-a-system-packagerhrUcmdoption-setup-register-userrhsUcmdoption-setup-configure-flagsrhth·huU cmdoption-setup-register-inplacerhvU$cmdoption-setup-hscolour-executablesrhwUsetup-configurerhxU&cmdoption-setup-configure-prog-optionsrhyh±hzU$cmdoption-setup-configure-sysconfdirrh{U*cmdoption-setup-configure-disable-coveragerh|U#cmdoption-setup-configure-libsubdirrh}Uhaddockr h~U%cmdoption-setup-haddock-html-locationr!hU3cmdoption-setup-configure-enable-executable-dynamicr"h€Uid4r#hU installing-packages-from-hackager$h‚hßhƒh±h„U(cmdoption-setup-haddock-hyperlink-sourcer%h…Uid1r&h†U#cmdoption-setup-register-gen-scriptr'h‡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-hU(cmdoption-setup-configure-program-suffixr.hŽU-cmdoption-setup-configure-exact-configurationr/hU#cmdoption-setup-configure-with-progr0hhåh‘Uid3r1h’U6cmdoption-setup-configure-disable-executable-strippingr2h“U'cmdoption-setup-configure-enable-staticr3h”Usetup-hscolourr4h•U cmdoption-setup-configure-prefixr5h–Uinstalling-packagesr6h—U#cmdoption-setup-haddock-executablesr7h˜Ucontrolling-flag-assignmentsr8h™U&cmdoption-setup-configure-enable-testsr9hšU'cmdoption-setup-configure-disable-testsr:h›Uid2r;hœU,cmdoption-setup-configure-disable-split-objsr<hUcmdoption-setup-test-arg-giver=hžU.cmdoption-setup-configure-extra-framework-dirsr>hŸUid10r?h U setup-copyr@h¡Ucmdoption-setup-verboserAh¢Ucmdoption-setup-configure-frBh£UhackagerCuUchildrenrD]rE(cdocutils.nodes section rF)rG}rH(U rawsourcerIUUparentrJhUsourcerKXE/home/refold/code/haskell/cabal-2.2/Cabal/doc/installing-packages.rstrLUtagnamerMUsectionrNU attributesrO}rP(UdupnamesrQ]UclassesrR]UbackrefsrS]UidsrT]rUhöaUnamesrV]rWhPauUlinerXKUdocumentrYhjD]rZ(cdocutils.nodes title r[)r\}r](jIX Configurationr^jJjGjKjLjMUtitler_jO}r`(jQ]jR]jS]jT]jV]ujXKjYhjD]racdocutils.nodes Text rbX Configurationrc…rd}re(jIj^jKNjXNjYhjJj\ubaubcsphinx.addnodes highlightlang rf)rg}rh(jIUjJjGjKjLjMU highlightlangrijO}rj(UlangXcabalUlinenothresholdI9223372036854775807 jT]jS]jQ]jR]jV]ujXKjYhjD]ubjF)rk}rl(jIUjJjGjKjLjMjNjO}rm(jQ]jR]jS]jT]rnjajV]rohZaujXKjYhjD]rp(j[)rq}rr(jIXOverviewrsjJjkjKjLjMj_jO}rt(jQ]jR]jS]jT]jV]ujXKjYhjD]rujbXOverviewrv…rw}rx(jIjsjKNjXNjYhjJjqubaubcdocutils.nodes paragraph ry)rz}r{(jIXü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 usingjJjkjKjLjMU paragraphr|jO}r}(jQ]jR]jS]jT]jV]ujXK jYhjD]r~(jbX"The global configuration file for r…r€}r(jIX"The global configuration file for jKNjXNjYhjJjzubcdocutils.nodes literal r‚)rƒ}r„(jIX``cabal-install``jO}r…(jQ]jR]jS]jT]jV]ujJjzjD]r†jbX cabal-installr‡…rˆ}r‰(jIUjJjƒubajMUliteralrŠubjbX is r‹…rŒ}r(jIX is jKNjXNjYhjJjzubj‚)rŽ}r(jIX``~/.cabal/config``jO}r(jQ]jR]jS]jT]jV]ujJjzjD]r‘jbX~/.cabal/configr’…r“}r”(jIUjJjŽubajMjŠubjbX . If you do not have this file, r•…r–}r—(jIX . If you do not have this file, jKNjXNjYhjJjzubj‚)r˜}r™(jIX ``cabal``jO}rš(jQ]jR]jS]jT]jV]ujJjzjD]r›jbXcabalrœ…r}rž(jIUjJj˜ubajMjŠubjbX- will create it for you on the first call to rŸ…r }r¡(jIX- will create it for you on the first call to jKNjXNjYhjJjzubj‚)r¢}r£(jIX``cabal update``jO}r¤(jQ]jR]jS]jT]jV]ujJjzjD]r¥jbX cabal updater¦…r§}r¨(jIUjJj¢ubajMjŠubjbX(. Alternatively, you can explicitly ask r©…rª}r«(jIX(. Alternatively, you can explicitly ask jKNjXNjYhjJjzubj‚)r¬}r­(jIX ``cabal``jO}r®(jQ]jR]jS]jT]jV]ujJjzjD]r¯jbXcabalr°…r±}r²(jIUjJj¬ubajMjŠubjbX to create it for you usingr³…r´}rµ(jIX to create it for you usingjKNjXNjYhjJjzubeubcdocutils.nodes literal_block r¶)r·}r¸(jIX$ cabal user-config updatejJjkjKjLjMU literal_blockr¹jO}rº(Ulinenosr»‰Ulanguager¼XconsoleU xml:spacer½Upreserver¾jT]jS]jQ]Uhighlight_argsr¿}jR]jV]ujXKjYhjD]rÀjbX$ cabal user-config updaterÁ…rÂ}rÃ(jIUjJj·ubaubjy)rÄ}rÅ(jIXDMost 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ÆjJjkjKjLjMj|jO}rÇ(jQ]jR]jS]jT]jV]ujXKjYhjD]rÈjbXDMost 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Ë(jIjÆjKNjXNjYhjJjÄubaubj¶)rÌ}rÍ(jIX-- executable-stripping: TruejJjkjKjLjMj¹jO}rÎ(j½j¾jT]jS]jQ]jR]jV]ujXKjYhjD]rÏjbX-- executable-stripping: TruerÐ…rÑ}rÒ(jIUjJjÌubaubjy)rÓ}rÔ(jIXmeans 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 tojJjkjKjLjMj|jO}rÕ(jQ]jR]jS]jT]jV]ujXKjYhjD]rÖ(jbXMmeans that the configuration file currently does not specify a value for the r×…rØ}rÙ(jIXMmeans that the configuration file currently does not specify a value for the jKNjXNjYhjJjÓubj‚)rÚ}rÛ(jIX``executable-stripping``jO}rÜ(jQ]jR]jS]jT]jV]ujJjÓjD]rÝjbXexecutable-strippingrÞ…rß}rà(jIUjJjÚubajMjŠubjbX= option (the line is commented out), and that the default is rá…râ}rã(jIX= option (the line is commented out), and that the default is jKNjXNjYhjJjÓubj‚)rä}rå(jIX``True``jO}ræ(jQ]jR]jS]jT]jV]ujJjÓjD]rçjbXTruerè…ré}rê(jIUjJjäubajMjŠubjbX]; if you wanted to disable stripping of executables by default, you would change this line torë…rì}rí(jIX]; if you wanted to disable stripping of executables by default, you would change this line tojKNjXNjYhjJjÓubeubj¶)rî}rï(jIXexecutable-stripping: FalsejJjkjKjLjMj¹jO}rð(j½j¾jT]jS]jQ]jR]jV]ujXK#jYhjD]rñjbXexecutable-stripping: Falserò…ró}rô(jIUjJjîubaubjy)rõ}rö(jIXtYou can also use ``cabal user-config update`` to migrate configuration files created by older versions of ``cabal``.jJjkjKjLjMj|jO}r÷(jQ]jR]jS]jT]jV]ujXK%jYhjD]rø(jbXYou can also use rù…rú}rû(jIXYou can also use jKNjXNjYhjJjõubj‚)rü}rý(jIX``cabal user-config update``jO}rþ(jQ]jR]jS]jT]jV]ujJjõjD]rÿjbXcabal user-config updater…r}r(jIUjJjüubajMjŠubjbX= to migrate configuration files created by older versions of r…r}r(jIX= to migrate configuration files created by older versions of jKNjXNjYhjJjõubj‚)r}r(jIX ``cabal``jO}r(jQ]jR]jS]jT]jV]ujJjõjD]r jbXcabalr …r }r (jIUjJjubajMjŠubjbX.…r }r(jIX.jKNjXNjYhjJjõubeubeubjF)r}r(jIUjJjGjKjLjMjNjO}r(jQ]jR]jS]jT]rháajV]rh:aujXK)jYhjD]r(j[)r}r(jIXRepository specificationrjJjjKjLjMj_jO}r(jQ]jR]jS]jT]jV]ujXK)jYhjD]rjbXRepository specificationr…r}r(jIjjKNjXNjYhjJjubaubjy)r}r(jIX»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:jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXK+jYhjD]r (jbXTAn important part of the configuration if the specification of the repository. When r!…r"}r#(jIXTAn important part of the configuration if the specification of the repository. When jKNjXNjYhjJjubj‚)r$}r%(jIX ``cabal``jO}r&(jQ]jR]jS]jT]jV]ujJjjD]r'jbXcabalr(…r)}r*(jIUjJj$ubajMjŠubjbX^ creates a default config file, it configures the repository to be the central Hackage server:r+…r,}r-(jIX^ creates a default config file, it configures the repository to be the central Hackage server:jKNjXNjYhjJjubeubj¶)r.}r/(jIXArepository hackage.haskell.org url: http://hackage.haskell.org/jJjjKjLjMj¹jO}r0(j½j¾jT]jS]jQ]jR]jV]ujXK1jYhjD]r1jbXArepository hackage.haskell.org url: http://hackage.haskell.org/r2…r3}r4(jIUjJj.ubaubjy)r5}r6(jIX¦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.jJjjKjLjMj|jO}r7(jQ]jR]jS]jT]jV]ujXK4jYhjD]r8(jbXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under r9…r:}r;(jIXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under jKNjXNjYhjJj5ubj‚)r<}r=(jIX)``~/.cabal/packages/hackage.haskell.org``jO}r>(jQ]jR]jS]jT]jV]ujJj5jD]r?jbX%~/.cabal/packages/hackage.haskell.orgr@…rA}rB(jIUjJj<ubajMjŠubjbXS (or whatever name you specify; you can change the prefix by changing the value of rC…rD}rE(jIXS (or whatever name you specify; you can change the prefix by changing the value of jKNjXNjYhjJj5ubj‚)rF}rG(jIX``remote-repo-cache``jO}rH(jQ]jR]jS]jT]jV]ujJj5jD]rIjbXremote-repo-cacherJ…rK}rL(jIUjJjFubajMjŠubjbX=). If you want, you can configure multiple repositories, and rM…rN}rO(jIX=). If you want, you can configure multiple repositories, and jKNjXNjYhjJj5ubj‚)rP}rQ(jIX ``cabal``jO}rR(jQ]jR]jS]jT]jV]ujJj5jD]rSjbXcabalrT…rU}rV(jIUjJjPubajMjŠubjbXE will combine them and be able to download packages from any of them.rW…rX}rY(jIXE will combine them and be able to download packages from any of them.jKNjXNjYhjJj5ubeubjF)rZ}r[(jIUjJjjKjLjMjNjO}r\(jQ]jR]jS]jT]r]jajV]r^hiaujXK=jYhjD]r_(j[)r`}ra(jIXUsing secure repositoriesrbjJjZjKjLjMj_jO}rc(jQ]jR]jS]jT]jV]ujXK=jYhjD]rdjbXUsing secure repositoriesre…rf}rg(jIjbjKNjXNjYhjJj`ubaubjy)rh}ri(jIX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:rjjJjZjKjLjMj|jO}rk(jQ]jR]jS]jT]jV]ujXK?jYhjD]rljbX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:rm…rn}ro(jIjjjKNjXNjYhjJjhubaubj¶)rp}rq(jIXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: jJjZjKjLjMj¹jO}rr(j½j¾jT]jS]jQ]jR]jV]ujXKEjYhjD]rsjbXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: rt…ru}rv(jIUjJjpubaubjy)rw}rx(jIXEThe ```` 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 ````.jJjZjKjLjMj|jO}ry(jQ]jR]jS]jT]jV]ujXKKjYhjD]rz(jbXThe r{…r|}r}(jIXThe jKNjXNjYhjJjwubj‚)r~}r(jIX````jO}r€(jQ]jR]jS]jT]jV]ujJjwjD]rjbXr‚…rƒ}r„(jIUjJj~ubajMjŠubjbX and r……r†}r‡(jIX and jKNjXNjYhjJjwubj‚)rˆ}r‰(jIX````jO}rŠ(jQ]jR]jS]jT]jV]ujJjwjD]r‹jbXrŒ…r}rŽ(jIUjJjˆubajMjŠubjbXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file r…r}r‘(jIXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file jKNjXNjYhjJjwubj‚)r’}r“(jIX ``root.json``jO}r”(jQ]jR]jS]jT]jV]ujJjwjD]r•jbX root.jsonr–…r—}r˜(jIUjJj’ubajMjŠubjbX (for instance, r™…rš}r›(jIX (for instance, jKNjXNjYhjJjwubcdocutils.nodes reference rœ)r}rž(jIX$http://hackage.haskell.org/root.jsonrŸjO}r (UrefurijŸjT]jS]jQ]jR]jV]ujJjwjD]r¡jbX$http://hackage.haskell.org/root.jsonr¢…r£}r¤(jIUjJjubajMU referencer¥ubjbX>) which the client needs to do verification. However, how can r¦…r§}r¨(jIX>) which the client needs to do verification. However, how can jKNjXNjYhjJjwubj‚)r©}rª(jIX ``cabal``jO}r«(jQ]jR]jS]jT]jV]ujJjwjD]r¬jbXcabalr­…r®}r¯(jIUjJj©ubajMjŠubjbX verify the r°…r±}r²(jIX verify the jKNjXNjYhjJjwubj‚)r³}r´(jIX ``root.json``jO}rµ(jQ]jR]jS]jT]jV]ujJjwjD]r¶jbX root.jsonr·…r¸}r¹(jIUjJj³ubajMjŠubjbX file rº…r»}r¼(jIX file jKNjXNjYhjJjwubcdocutils.nodes emphasis r½)r¾}r¿(jIX*itself*jO}rÀ(jQ]jR]jS]jT]jV]ujJjwjD]rÁjbXitselfrÂ…rÃ}rÄ(jIUjJj¾ubajMUemphasisrÅubjbXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, rÆ…rÇ}rÈ(jIXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, jKNjXNjYhjJjwubj‚)rÉ}rÊ(jIX ``cabal``jO}rË(jQ]jR]jS]jT]jV]ujJjwjD]rÌjbXcabalrÍ…rÎ}rÏ(jIUjJjÉubajMjŠubjbX! will verify that the downloaded rÐ…rÑ}rÒ(jIX! will verify that the downloaded jKNjXNjYhjJjwubj‚)rÓ}rÔ(jIX ``root.json``jO}rÕ(jQ]jR]jS]jT]jV]ujJjwjD]rÖjbX root.jsonr×…rØ}rÙ(jIUjJjÓubajMjŠubjbX$ file has been signed with at least rÚ…rÛ}rÜ(jIX$ file has been signed with at least jKNjXNjYhjJjwubj‚)rÝ}rÞ(jIX````jO}rß(jQ]jR]jS]jT]jV]ujJjwjD]ràjbXrá…râ}rã(jIUjJjÝubajMjŠubjbX keys from your set of rä…rå}ræ(jIX keys from your set of jKNjXNjYhjJjwubj‚)rç}rè(jIX````jO}ré(jQ]jR]jS]jT]jV]ujJjwjD]rêjbXrë…rì}rí(jIUjJjçubajMjŠubjbX.…rî}rï(jIX.jKNjXNjYhjJjwubeubjy)rð}rñ(jIX>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.jJjZjKjLjMj|jO}rò(jQ]jR]jS]jT]jV]ujXKUjYhjD]ró(jbXIYou can, but are not recommended to, omit these two fields. In that case rô…rõ}rö(jIXIYou can, but are not recommended to, omit these two fields. In that case jKNjXNjYhjJjðubj‚)r÷}rø(jIX ``cabal``jO}rù(jQ]jR]jS]jT]jV]ujJjðjD]rújbXcabalrû…rü}rý(jIUjJj÷ubajMjŠubjbX will download the rþ…rÿ}r(jIX will download the jKNjXNjYhjJjðubj‚)r}r(jIX ``root.json``jO}r(jQ]jR]jS]jT]jV]ujJjðjD]rjbX root.jsonr…r}r(jIUjJjubajMjŠubjbX— 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 (jIX— field and use it without verification. Although this bootstrapping step is then unsafe, all subsequent access is secure (provided that the downloaded jKNjXNjYhjJjðubj‚)r }r (jIX ``root.json``jO}r (jQ]jR]jS]jT]jV]ujJjðjD]rjbX root.jsonr…r}r(jIUjJj ubajMjŠubjbX+ was not tempered with). Of course, adding r…r}r(jIX+ was not tempered with). Of course, adding jKNjXNjYhjJjðubj‚)r}r(jIX ``root-keys``jO}r(jQ]jR]jS]jT]jV]ujJjðjD]rjbX root-keysr…r}r(jIUjJjubajMjŠubjbX and r…r}r(jIX and jKNjXNjYhjJjðubj‚)r}r (jIX``key-threshold``jO}r!(jQ]jR]jS]jT]jV]ujJjðjD]r"jbX key-thresholdr#…r$}r%(jIUjJjubajMjŠubjbXÉ 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((jIXÉ 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 jKNjXNjYhjJjðubj‚)r)}r*(jIX ``cabal``jO}r+(jQ]jR]jS]jT]jV]ujJjðjD]r,jbXcabalr-…r.}r/(jIUjJj)ubajMjŠubjbX proper.r0…r1}r2(jIX proper.jKNjXNjYhjJjðubeubjy)r3}r4(jIXrMore information about the security infrastructure can be found at https://github.com/well-typed/hackage-security.jJjZjKjLjMj|jO}r5(jQ]jR]jS]jT]jV]ujXK_jYhjD]r6(jbXCMore information about the security infrastructure can be found at r7…r8}r9(jIXCMore information about the security infrastructure can be found at jKNjXNjYhjJj3ubjœ)r:}r;(jIX.https://github.com/well-typed/hackage-securityr<jO}r=(Urefurij<jT]jS]jQ]jR]jV]ujJj3jD]r>jbX.https://github.com/well-typed/hackage-securityr?…r@}rA(jIUjJj:ubajMj¥ubjbX.…rB}rC(jIX.jKNjXNjYhjJj3ubeubeubjF)rD}rE(jIUjJjjKjLjMjNjO}rF(jQ]jR]jS]jT]rGhÖajV]rHh/aujXKcjYhjD]rI(j[)rJ}rK(jIXLegacy repositoriesrLjJjDjKjLjMj_jO}rM(jQ]jR]jS]jT]jV]ujXKcjYhjD]rNjbXLegacy repositoriesrO…rP}rQ(jIjLjKNjXNjYhjJjJubaubjy)rR}rS(jIXaCurrently ``cabal`` supports two kinds of “legacy†repositories. The first is specified usingjJjDjKjLjMj|jO}rT(jQ]jR]jS]jT]jV]ujXKejYhjD]rU(jbX Currently rV…rW}rX(jIX Currently jKNjXNjYhjJjRubj‚)rY}rZ(jIX ``cabal``jO}r[(jQ]jR]jS]jT]jV]ujJjRjD]r\jbXcabalr]…r^}r_(jIUjJjYubajMjŠubjbXN supports two kinds of “legacy†repositories. The first is specified usingr`…ra}rb(jIXN supports two kinds of “legacy†repositories. The first is specified usingjKNjXNjYhjJjRubeubj¶)rc}rd(jIXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archivejJjDjKjLjMj¹jO}re(j½j¾jT]jS]jQ]jR]jV]ujXKjjYhjD]rfjbXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archiverg…rh}ri(jIUjJjcubaubjy)rj}rk(jIX This is just syntactic sugar forrljJjDjKjLjMj|jO}rm(jQ]jR]jS]jT]jV]ujXKljYhjD]rnjbX This is just syntactic sugar forro…rp}rq(jIjljKNjXNjYhjJjjubaubj¶)rr}rs(jIXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archivejJjDjKjLjMj¹jO}rt(j½j¾jT]jS]jQ]jR]jV]ujXKpjYhjD]rujbXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archiverv…rw}rx(jIUjJjrubaubjy)ry}rz(jIX°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/``.jJjDjKjLjMj|jO}r{(jQ]jR]jS]jT]jV]ujXKsjYhjD]r|(jbXAalthough, in (and only in) the specific case of Hackage, the URL r}…r~}r(jIXAalthough, in (and only in) the specific case of Hackage, the URL jKNjXNjYhjJjyubj‚)r€}r(jIX/``http://hackage.haskell.org/packages/archive``jO}r‚(jQ]jR]jS]jT]jV]ujJjyjD]rƒjbX+http://hackage.haskell.org/packages/archiver„…r…}r†(jIUjJj€ubajMjŠubjbX will be silently translated to r‡…rˆ}r‰(jIX will be silently translated to jKNjXNjYhjJjyubj‚)rŠ}r‹(jIX``http://hackage.haskell.org/``jO}rŒ(jQ]jR]jS]jT]jV]ujJjyjD]rjbXhttp://hackage.haskell.org/rŽ…r}r(jIUjJjŠubajMjŠubjbX.…r‘}r’(jIX.jKNjXNjYhjJjyubeubjy)r“}r”(jIXNThe second kind of legacy repositories are so-called “local†repositories:r•jJjDjKjLjMj|jO}r–(jQ]jR]jS]jT]jV]ujXKwjYhjD]r—jbXNThe second kind of legacy repositories are so-called “local†repositories:r˜…r™}rš(jIj•jKNjXNjYhjJj“ubaubj¶)r›}rœ(jIX-local-repo: my-local-repo:/path/to/local/repojJjDjKjLjMj¹jO}r(j½j¾jT]jS]jQ]jR]jV]ujXK|jYhjD]ržjbX-local-repo: my-local-repo:/path/to/local/reporŸ…r }r¡(jIUjJj›ubaubjy)r¢}r£(jIXÛ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¤jJjDjKjLjMj|jO}r¥(jQ]jR]jS]jT]jV]ujXK~jYhjD]r¦jbXÛ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©(jIj¤jKNjXNjYhjJj¢ubaubeubjF)rª}r«(jIUjJjjKjLjMjNjO}r¬(jQ]jR]jS]jT]r­h»ajV]r®haujXK„jYhjD]r¯(j[)r°}r±(jIXSecure local repositoriesr²jJjªjKjLjMj_jO}r³(jQ]jR]jS]jT]jV]ujXK„jYhjD]r´jbXSecure local repositoriesrµ…r¶}r·(jIj²jKNjXNjYhjJj°ubaubjy)r¸}r¹(jIXxIf you want to use repositories on your local file system, it is recommended instead to use a *secure* local repository:jJjªjKjLjMj|jO}rº(jQ]jR]jS]jT]jV]ujXK†jYhjD]r»(jbX^If you want to use repositories on your local file system, it is recommended instead to use a r¼…r½}r¾(jIX^If you want to use repositories on your local file system, it is recommended instead to use a jKNjXNjYhjJj¸ubj½)r¿}rÀ(jIX*secure*jO}rÁ(jQ]jR]jS]jT]jV]ujJj¸jD]rÂjbXsecurerÃ…rÄ}rÅ(jIUjJj¿ubajMjÅubjbX local repository:rÆ…rÇ}rÈ(jIX local repository:jKNjXNjYhjJj¸ubeubj¶)rÉ}rÊ(jIX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: jJjªjKjLjMj¹jO}rË(j½j¾jT]jS]jQ]jR]jV]ujXK‹jYhjD]rÌjbX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: rÍ…rÎ}rÏ(jIUjJjÉubaubjy)rÐ}rÑ(jIX²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.jJjªjKjLjMj|jO}rÒ(jQ]jR]jS]jT]jV]ujXK‘jYhjD]rÓ(jbX^The layout of these secure local repos matches the layout of remote repositories exactly; the rÔ…rÕ}rÖ(jIX^The layout of these secure local repos matches the layout of remote repositories exactly; the jKNjXNjYhjJjÐubjœ)r×}rØ(jIXhackage-repo-tooljO}rÙ(UrefuriX4http://hackage.haskell.org/package/hackage-repo-tooljT]jS]jQ]jR]jV]Uinternal‰ujJjÐjD]rÚjbXhackage-repo-toolrÛ…rÜ}rÝ(jIUjJj×ubajMj¥ubjbX4 can be used to create and manage such repositories.rÞ…rß}rà(jIX4 can be used to create and manage such repositories.jKNjXNjYhjJjÐubeubcdocutils.nodes target rá)râ}rã(jIX.. _installing-packages:jJjªjKjLjMUtargeträjO}rå(jT]jS]jQ]jR]jV]Urefidræj6ujXK•jYhjD]ubeubeubeubjF)rç}rè(jIUjJhjKjLUexpect_referenced_by_nameré}rêh–jâsjMjNjO}rë(jQ]jR]jS]jT]rì(h½j6ejV]rí(hh–eujXK˜jYhUexpect_referenced_by_idrî}rïj6jâsjD]rð(j[)rñ}rò(jIX Building and installing packagesrójJjçjKjLjMj_jO}rô(jQ]jR]jS]jT]jV]ujXK˜jYhjD]rõjbX Building and installing packagesrö…r÷}rø(jIjójKNjXNjYhjJjñubaubjf)rù}rú(jIUjJjçjKjLjMjijO}rû(UlangXconsoleUlinenothresholdI9223372036854775807 jT]jS]jQ]jR]jV]ujXK›jYhjD]ubjy)rü}rý(jIXŽ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:jJjçjKjLjMj|jO}rþ(jQ]jR]jS]jT]jV]ujXKœjYhjD]rÿ(jbX{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(jIXyAfter you've unpacked a Cabal package, you can build it by moving into the root directory of the package and running the jKNjXNjYhjJjüubj‚)r}r(jIX ``cabal``jO}r(jQ]jR]jS]jT]jV]ujJjüjD]rjbXcabalr…r}r (jIUjJjubajMjŠubjbX tool there:r …r }r (jIX tool there:jKNjXNjYhjJjüubeubj¶)r }r(jIX$ cabal [command] [option...]jJjçjKjLjMj¹jO}r(j½j¾jT]jS]jQ]jR]jV]ujXK¡jYhjD]rjbX$ cabal [command] [option...]r…r}r(jIUjJj ubaubjy)r}r(jIXNThe *command* argument selects a particular step in the build/install process.jJjçjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXK£jYhjD]r(jbXThe r…r}r(jIXThe jKNjXNjYhjJjubj½)r}r(jIX *command*jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXcommandr…r }r!(jIUjJjubajMjÅubjbXA argument selects a particular step in the build/install process.r"…r#}r$(jIXA argument selects a particular step in the build/install process.jKNjXNjYhjJjubeubjy)r%}r&(jIX5You can also get a summary of the command syntax withr'jJjçjKjLjMj|jO}r((jQ]jR]jS]jT]jV]ujXK¦jYhjD]r)jbX5You can also get a summary of the command syntax withr*…r+}r,(jIj'jKNjXNjYhjJj%ubaubj¶)r-}r.(jIX $ cabal helpjJjçjKjLjMj¹jO}r/(j½j¾jT]jS]jQ]jR]jV]ujXKªjYhjD]r0jbX $ cabal helpr1…r2}r3(jIUjJj-ubaubjy)r4}r5(jIXIAlternatively, you can also use the ``Setup.hs`` or ``Setup.lhs`` script:jJjçjKjLjMj|jO}r6(jQ]jR]jS]jT]jV]ujXK¬jYhjD]r7(jbX$Alternatively, you can also use the r8…r9}r:(jIX$Alternatively, you can also use the jKNjXNjYhjJj4ubj‚)r;}r<(jIX ``Setup.hs``jO}r=(jQ]jR]jS]jT]jV]ujJj4jD]r>jbXSetup.hsr?…r@}rA(jIUjJj;ubajMjŠubjbX or rB…rC}rD(jIX or jKNjXNjYhjJj4ubj‚)rE}rF(jIX ``Setup.lhs``jO}rG(jQ]jR]jS]jT]jV]ujJj4jD]rHjbX Setup.lhsrI…rJ}rK(jIUjJjEubajMjŠubjbX script:rL…rM}rN(jIX script:jKNjXNjYhjJj4ubeubj¶)rO}rP(jIX+$ runhaskell Setup.hs [command] [option...]jJjçjKjLjMj¹jO}rQ(j½j¾jT]jS]jQ]jR]jV]ujXK±jYhjD]rRjbX+$ runhaskell Setup.hs [command] [option...]rS…rT}rU(jIUjJjOubaubjy)rV}rW(jIX+For the summary of the command syntax, run:rXjJjçjKjLjMj|jO}rY(jQ]jR]jS]jT]jV]ujXK³jYhjD]rZjbX+For the summary of the command syntax, run:r[…r\}r](jIjXjKNjXNjYhjJjVubaubj¶)r^}r_(jIX $ cabal helpjJjçjKjLjMj¹jO}r`(j½j¾jT]jS]jQ]jR]jV]ujXK·jYhjD]rajbX $ cabal helprb…rc}rd(jIUjJj^ubaubjy)re}rf(jIXorrgjJjçjKjLjMj|jO}rh(jQ]jR]jS]jT]jV]ujXK¹jYhjD]rijbXorrj…rk}rl(jIjgjKNjXNjYhjJjeubaubj¶)rm}rn(jIX$ runhaskell Setup.hs --helpjJjçjKjLjMj¹jO}ro(j½j¾jT]jS]jQ]jR]jV]ujXK½jYhjD]rpjbX$ runhaskell Setup.hs --helprq…rr}rs(jIUjJjmubaubjF)rt}ru(jIUjJjçjKjLjMjNjO}rv(jQ]jR]jS]jT]rwjajV]rxhqaujXKÀjYhjD]ry(j[)rz}r{(jIX(Building and installing a system packager|jJjtjKjLjMj_jO}r}(jQ]jR]jS]jT]jV]ujXKÀjYhjD]r~jbX(Building and installing a system packager…r€}r(jIj|jKNjXNjYhjJjzubaubj¶)r‚}rƒ(jIX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installjJjtjKjLjMj¹jO}r„(j½j¾jT]jS]jQ]jR]jV]ujXKÄjYhjD]r…jbX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installr†…r‡}rˆ(jIUjJj‚ubaubjy)r‰}rŠ(jIX 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‹jJjtjKjLjMj|jO}rŒ(jQ]jR]jS]jT]jV]ujXKÈjYhjD]rjbX 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(jIj‹jKNjXNjYhjJj‰ubaubeubjF)r‘}r’(jIUjJjçjKjLjMjNjO}r“(jQ]jR]jS]jT]r”hÍajV]r•h&aujXKÎjYhjD]r–(j[)r—}r˜(jIX&Building and installing a user packager™jJj‘jKjLjMj_jO}rš(jQ]jR]jS]jT]jV]ujXKÎjYhjD]r›jbX&Building and installing a user packagerœ…r}rž(jIj™jKNjXNjYhjJj—ubaubj¶)rŸ}r (jIX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installjJj‘jKjLjMj¹jO}r¡(j½j¾jT]jS]jQ]jR]jV]ujXKÒjYhjD]r¢jbX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installr£…r¤}r¥(jIUjJjŸubaubjy)r¦}r§(jIXThe package is installed under the user's home directory and is registered in the user's package database (:option:`setup configure --user`).jJj‘jKjLjMj|jO}r¨(jQ]jR]jS]jT]jV]ujXKÖjYhjD]r©(jbXoThe package is installed under the user’s home directory and is registered in the user’s package database (rª…r«}r¬(jIXkThe package is installed under the user's home directory and is registered in the user's package database (jKNjXNjYhjJj¦ubcsphinx.addnodes pending_xref r­)r®}r¯(jIX :option:`setup configure --user`r°jJj¦jKjLjMU pending_xrefr±jO}r²(UreftypeXoptionUrefwarnr³ˆU reftargetr´Xsetup configure --userU refdomainXstdrµjT]jS]U refexplicit‰jQ]jR]jV]Urefdocr¶Xinstalling-packagesr·U std:programr¸NujXKÖjD]r¹j‚)rº}r»(jIj°jO}r¼(jQ]jR]r½(Uxrefr¾jµX std-optionr¿ejS]jT]jV]ujJj®jD]rÀjbXsetup configure --userrÁ…rÂ}rÃ(jIUjJjºubajMjŠubaubjbX).rÄ…rÅ}rÆ(jIX).jKNjXNjYhjJj¦ubeubeubjF)rÇ}rÈ(jIUjJjçjKjLjMjNjO}rÉ(jQ]jR]jS]jT]rÊj$ajV]rËhaujXKÚjYhjD]rÌ(j[)rÍ}rÎ(jIX Installing packages from HackagerÏjJjÇjKjLjMj_jO}rÐ(jQ]jR]jS]jT]jV]ujXKÚjYhjD]rÑjbX Installing packages from HackagerÒ…rÓ}rÔ(jIjÏjKNjXNjYhjJjÍubaubjy)rÕ}rÖ(jIX”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:jJjÇjKjLjMj|jO}r×(jQ]jR]jS]jT]jV]ujXKÜjYhjD]rØ(jbXThe rÙ…rÚ}rÛ(jIXThe jKNjXNjYhjJjÕubj‚)rÜ}rÝ(jIX ``cabal``jO}rÞ(jQ]jR]jS]jT]jV]ujJjÕjD]rßjbXcabalrà…rá}râ(jIUjJjÜubajMjŠubjbX8 tool also can download, configure, build and install a rã…rä}rå(jIX8 tool also can download, configure, build and install a jKNjXNjYhjJjÕubjœ)ræ}rç(jIXHackage_UresolvedrèKjJjÕjMj¥jO}ré(UnameXHackageUrefurirêXhttp://hackage.haskell.org/rëjT]jS]jQ]jR]jV]ujD]rìjbXHackagerí…rî}rï(jIUjJjæubaubjbXG package and all of its dependencies in a single step. To do this, run:rð…rñ}rò(jIXG package and all of its dependencies in a single step. To do this, run:jKNjXNjYhjJjÕubeubj¶)ró}rô(jIX$ cabal install [PACKAGE...]jJjÇjKjLjMj¹jO}rõ(j½j¾jT]jS]jQ]jR]jV]ujXKâjYhjD]röjbX$ cabal install [PACKAGE...]r÷…rø}rù(jIUjJjóubaubjy)rú}rû(jIXFTo browse the list of available packages, visit the Hackage_ web site.jJjÇjKjLjMj|jO}rü(jQ]jR]jS]jT]jV]ujXKäjYhjD]rý(jbX4To browse the list of available packages, visit the rþ…rÿ}r(jIX4To browse the list of available packages, visit the jKNjXNjYhjJjúubjœ)r}r(jIXHackage_jèKjJjújMj¥jO}r(UnameXHackagejêjëjT]jS]jQ]jR]jV]ujD]rjbXHackager…r}r(jIUjJjubaubjbX web site.r…r }r (jIX web site.jKNjXNjYhjJjúubeubeubjF)r }r (jIUjJjçjKjLjMjNjO}r (jQ]jR]jS]jT]rjajV]rhmaujXKèjYhjD]r(j[)r}r(jIXDeveloping with sandboxesrjJj jKjLjMj_jO}r(jQ]jR]jS]jT]jV]ujXKèjYhjD]rjbXDeveloping with sandboxesr…r}r(jIjjKNjXNjYhjJjubaubjy)r}r(jIXé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.jJj jKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXKêjYhjD]r(jbXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using r…r}r(jIXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using jKNjXNjYhjJjubj‚)r }r!(jIX%``cabal install --only-dependencies``jO}r"(jQ]jR]jS]jT]jV]ujJjjD]r#jbX!cabal install --only-dependenciesr$…r%}r&(jIUjJj ubajMjŠubjbXZ). 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)(jIXT). 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.jKNjXNjYhjJjubeubjy)r*}r+(jIXiFor more on sandboxes, see also `this article `__.jJj jKjLjMj|jO}r,(jQ]jR]jS]jT]jV]ujXKójYhjD]r-(jbX For more on sandboxes, see also r.…r/}r0(jIX For more on sandboxes, see also jKNjXNjYhjJj*ubjœ)r1}r2(jIXH`this article `__jO}r3(UnameX this articlejêX5http://coldwa.st/e/blog/2013-08-20-Cabal-sandbox.htmljT]jS]jQ]jR]jV]ujJj*jD]r4jbX this articler5…r6}r7(jIUjJj1ubajMj¥ubjbX.…r8}r9(jIX.jKNjXNjYhjJj*ubeubjF)r:}r;(jIUjJj jKjLjMjNjO}r<(jQ]jR]jS]jT]r=hÁajV]r>haujXK÷jYhjD]r?(j[)r@}rA(jIXSandboxes: basic usagerBjJj:jKjLjMj_jO}rC(jQ]jR]jS]jT]jV]ujXK÷jYhjD]rDjbXSandboxes: basic usagerE…rF}rG(jIjBjKNjXNjYhjJj@ubaubjy)rH}rI(jIXµ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.jJj:jKjLjMj|jO}rJ(jQ]jR]jS]jT]jV]ujXKùjYhjD]rK(jbX<To initialise a fresh sandbox in the current directory, run rL…rM}rN(jIX<To initialise a fresh sandbox in the current directory, run jKNjXNjYhjJjHubj‚)rO}rP(jIX``cabal sandbox init``jO}rQ(jQ]jR]jS]jT]jV]ujJjHjD]rRjbXcabal sandbox initrS…rT}rU(jIUjJjOubajMjŠubjbX#. All subsequent commands (such as rV…rW}rX(jIX#. All subsequent commands (such as jKNjXNjYhjJjHubj‚)rY}rZ(jIX ``build``jO}r[(jQ]jR]jS]jT]jV]ujJjHjD]r\jbXbuildr]…r^}r_(jIUjJjYubajMjŠubjbX and r`…ra}rb(jIX and jKNjXNjYhjJjHubj‚)rc}rd(jIX ``install``jO}re(jQ]jR]jS]jT]jV]ujJjHjD]rfjbXinstallrg…rh}ri(jIUjJjcubajMjŠubjbX') from this point will use the sandbox.rj…rk}rl(jIX') from this point will use the sandbox.jKNjXNjYhjJjHubeubj¶)rm}rn(jIXþ$ 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 sandboxjJj:jKjLjMj¹jO}ro(j½j¾jT]jS]jQ]jR]jV]ujXKÿjYhjD]rpjbXþ$ 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 sandboxrq…rr}rs(jIUjJjmubaubjy)rt}ru(jIX`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.jJj:jKjLjMj|jO}rv(jQ]jR]jS]jT]jV]ujXMjYhjD]rw(jbXÉ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 rx…ry}rz(jIXÉ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 jKNjXNjYhjJjtubj‚)r{}r|(jIX``cabal sandbox add-source``jO}r}(jQ]jR]jS]jT]jV]ujJjtjD]r~jbXcabal sandbox add-sourcer…r€}r(jIUjJj{ubajMjŠubjbX# command - think of it as “local r‚…rƒ}r„(jIX! command - think of it as "local jKNjXNjYhjJjtubjœ)r…}r†(jIXHackage_jèKjJjtjMj¥jO}r‡(UnameXHackagejêjëjT]jS]jQ]jR]jV]ujD]rˆjbXHackager‰…rŠ}r‹(jIUjJj…ubaubjbXTâ€. If an add-source dependency is later modified, it is reinstalled automatically.rŒ…r}rŽ(jIXR". If an add-source dependency is later modified, it is reinstalled automatically.jKNjXNjYhjJjtubeubj¶)r}r(jIXš$ 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 reinstalledjJj:jKjLjMj¹jO}r‘(j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]r’jbXš$ 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•(jIUjJjubaubjy)r–}r—(jIX­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.jJj:jKjLjMj|jO}r˜(jQ]jR]jS]jT]jV]ujXMjYhjD]r™(jbXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (rš…r›}rœ(jIXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (jKNjXNjYhjJj–ubj‚)r}rž(jIX``$HOME/cabal/config``jO}rŸ(jQ]jR]jS]jT]jV]ujJj–jD]r jbX$HOME/cabal/configr¡…r¢}r£(jIUjJjubajMjŠubjbXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a r¤…r¥}r¦(jIXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a jKNjXNjYhjJj–ubj‚)r§}r¨(jIX``cabal.config``jO}r©(jQ]jR]jS]jT]jV]ujJj–jD]rªjbX cabal.configr«…r¬}r­(jIUjJj§ubajMjŠubjbX& file in the same directory with your r®…r¯}r°(jIX& file in the same directory with your jKNjXNjYhjJj–ubj‚)r±}r²(jIX``cabal.sandbox.config``jO}r³(jQ]jR]jS]jT]jV]ujJj–jD]r´jbXcabal.sandbox.configrµ…r¶}r·(jIUjJj±ubajMjŠubjbX (which was created by r¸…r¹}rº(jIX (which was created by jKNjXNjYhjJj–ubj‚)r»}r¼(jIX``sandbox init``jO}r½(jQ]jR]jS]jT]jV]ujJj–jD]r¾jbX sandbox initr¿…rÀ}rÁ(jIUjJj»ubajMjŠubjbX?). This file has the same syntax as the main Cabal config file.rÂ…rÃ}rÄ(jIX?). This file has the same syntax as the main Cabal config file.jKNjXNjYhjJj–ubeubj¶)rÅ}rÆ(jIX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filejJj:jKjLjMj¹jO}rÇ(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÈjbX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filerÉ…rÊ}rË(jIUjJjÅubaubjy)rÌ}rÍ(jIXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÎjJj:jKjLjMj|jO}rÏ(jQ]jR]jS]jT]jV]ujXM!jYhjD]rÐjbXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÑ…rÒ}rÓ(jIjÎjKNjXNjYhjJjÌubaubj¶)rÔ}rÕ(jIXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodjJj:jKjLjMj¹jO}rÖ(j½j¾jT]jS]jQ]jR]jV]ujXM&jYhjD]r×jbXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodrØ…rÙ}rÚ(jIUjJjÔubaubeubjF)rÛ}rÜ(jIUjJj jKjLjMjNjO}rÝ(jQ]jR]jS]jT]rÞh²ajV]rßh aujXM*jYhjD]rà(j[)rá}râ(jIXSandboxes: advanced usagerãjJjÛjKjLjMj_jO}rä(jQ]jR]jS]jT]jV]ujXM*jYhjD]råjbXSandboxes: advanced usageræ…rç}rè(jIjãjKNjXNjYhjJjáubaubjy)ré}rê(jIXThe 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.jJjÛjKjLjMj|jO}rë(jQ]jR]jS]jT]jV]ujXM,jYhjD]rì(jbXThe default behaviour of the rí…rî}rï(jIXThe default behaviour of the jKNjXNjYhjJjéubj‚)rð}rñ(jIX``add-source``jO}rò(jQ]jR]jS]jT]jV]ujJjéjD]rójbX add-sourcerô…rõ}rö(jIUjJjðubajMjŠubjbX· 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ù(jIX· 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 jKNjXNjYhjJjéubj‚)rú}rû(jIX``add-source --snapshot``jO}rü(jQ]jR]jS]jT]jV]ujJjéjD]rýjbXadd-source --snapshotrþ…rÿ}r(jIUjJjúubajMjŠubjbX5, which disables the change tracking. In addition to r…r}r(jIX5, which disables the change tracking. In addition to jKNjXNjYhjJjéubj‚)r}r(jIX``add-source``jO}r(jQ]jR]jS]jT]jV]ujJjéjD]rjbX add-sourcer…r }r (jIUjJjubajMjŠubjbX, there are also r …r }r (jIX, there are also jKNjXNjYhjJjéubj‚)r}r(jIX``list-sources``jO}r(jQ]jR]jS]jT]jV]ujJjéjD]rjbX list-sourcesr…r}r(jIUjJjubajMjŠubjbX and r…r}r(jIX and jKNjXNjYhjJjéubj‚)r}r(jIX``delete-source``jO}r(jQ]jR]jS]jT]jV]ujJjéjD]rjbX delete-sourcer…r}r(jIUjJjubajMjŠubjbX commands.r…r }r!(jIX commands.jKNjXNjYhjJjéubeubjy)r"}r#(jIXSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the ``--sandbox`` option:jJjÛjKjLjMj|jO}r$(jQ]jR]jS]jT]jV]ujXM3jYhjD]r%(jbXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the r&…r'}r((jIXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the jKNjXNjYhjJj"ubj‚)r)}r*(jIX ``--sandbox``jO}r+(jQ]jR]jS]jT]jV]ujJj"jD]r,jbX --sandboxr-…r.}r/(jIUjJj)ubajMjŠubjbX option:r0…r1}r2(jIX option:jKNjXNjYhjJj"ubeubj¶)r3}r4(jIXþ$ 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-sandboxjJjÛjKjLjMj¹jO}r5(j½j¾jT]jS]jQ]jR]jV]ujXM8jYhjD]r6jbXþ$ 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-sandboxr7…r8}r9(jIUjJj3ubaubjy)r:}r;(jIXõ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``).jJjÛjKjLjMj|jO}r<(jQ]jR]jS]jT]jV]ujXM@jYhjD]r=(jbX Note that r>…r?}r@(jIX Note that jKNjXNjYhjJj:ubj‚)rA}rB(jIX"``cabal sandbox init --sandbox .``jO}rC(jQ]jR]jS]jT]jV]ujJj:jD]rDjbXcabal sandbox init --sandbox .rE…rF}rG(jIUjJjAubajMjŠubjbX@ puts all sandbox files into the current directory. By default, rH…rI}rJ(jIX@ puts all sandbox files into the current directory. By default, jKNjXNjYhjJj:ubj‚)rK}rL(jIX``cabal sandbox init``jO}rM(jQ]jR]jS]jT]jV]ujJj:jD]rNjbXcabal sandbox initrO…rP}rQ(jIUjJjKubajMjŠubjbX] initialises a new sandbox in a newly-created subdirectory of the current working directory (rR…rS}rT(jIX] initialises a new sandbox in a newly-created subdirectory of the current working directory (jKNjXNjYhjJj:ubj‚)rU}rV(jIX``./.cabal-sandbox``jO}rW(jQ]jR]jS]jT]jV]ujJj:jD]rXjbX./.cabal-sandboxrY…rZ}r[(jIUjJjUubajMjŠubjbX).r\…r]}r^(jIX).jKNjXNjYhjJj:ubeubjy)r_}r`(jIXcUsing multiple different compiler versions simultaneously is also supported, via the ``-w`` option:jJjÛjKjLjMj|jO}ra(jQ]jR]jS]jT]jV]ujXMEjYhjD]rb(jbXUUsing multiple different compiler versions simultaneously is also supported, via the rc…rd}re(jIXUUsing multiple different compiler versions simultaneously is also supported, via the jKNjXNjYhjJj_ubj‚)rf}rg(jIX``-w``jO}rh(jQ]jR]jS]jT]jV]ujJj_jD]rijbX-wrj…rk}rl(jIUjJjfubajMjŠubjbX option:rm…rn}ro(jIX option:jKNjXNjYhjJj_ubeubj¶)rp}rq(jIXs$ 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 buildjJjÛjKjLjMj¹jO}rr(j½j¾jT]jS]jQ]jR]jV]ujXMJjYhjD]rsjbXs$ 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 buildrt…ru}rv(jIUjJjpubaubjy)rw}rx(jIXIIt 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:jJjÛjKjLjMj|jO}ry(jQ]jR]jS]jT]jV]ujXMRjYhjD]rz(jbXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. r{…r|}r}(jIXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. jKNjXNjYhjJjwubj‚)r~}r(jIX ``ghc-pkg``jO}r€(jQ]jR]jS]jT]jV]ujJjwjD]rjbXghc-pkgr‚…rƒ}r„(jIUjJj~ubajMjŠubjbXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The r……r†}r‡(jIXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The jKNjXNjYhjJjwubj‚)rˆ}r‰(jIX``cabal sandbox hc-pkg``jO}rŠ(jQ]jR]jS]jT]jV]ujJjwjD]r‹jbXcabal sandbox hc-pkgrŒ…r}rŽ(jIUjJjˆubajMjŠubjbXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:r…r}r‘(jIXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:jKNjXNjYhjJjwubeubj¶)r’}r“(jIXâ$ 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' [...]jJjÛjKjLjMj¹jO}r”(j½j¾jT]jS]jQ]jR]jV]ujXMZjYhjD]r•jbXâ$ 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˜(jIUjJj’ubaubjy)r™}rš(jIX¢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``.jJjÛjKjLjMj|jO}r›(jQ]jR]jS]jT]jV]ujXMajYhjD]rœ(jbXThe r…rž}rŸ(jIXThe jKNjXNjYhjJj™ubj‚)r }r¡(jIX``--require-sandbox``jO}r¢(jQ]jR]jS]jT]jV]ujJj™jD]r£jbX--require-sandboxr¤…r¥}r¦(jIUjJj ubajMjŠubjbX* option makes all sandbox-aware commands (r§…r¨}r©(jIX* option makes all sandbox-aware commands (jKNjXNjYhjJj™ubj‚)rª}r«(jIX ``install``jO}r¬(jQ]jR]jS]jT]jV]ujJj™jD]r­jbXinstallr®…r¯}r°(jIUjJjªubajMjŠubjbX/…r±}r²(jIX/jKNjXNjYhjJj™ubj‚)r³}r´(jIX ``build``jO}rµ(jQ]jR]jS]jT]jV]ujJj™jD]r¶jbXbuildr·…r¸}r¹(jIUjJj³ubajMjŠubjbXÄ/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¼(jIXÄ/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 (jKNjXNjYhjJj™ubj‚)r½}r¾(jIX``~/.cabal/config``jO}r¿(jQ]jR]jS]jT]jV]ujJj™jD]rÀjbX~/.cabal/configrÁ…rÂ}rÃ(jIUjJj½ubajMjŠubjbX) or the per-project one (rÄ…rÅ}rÆ(jIX) or the per-project one (jKNjXNjYhjJj™ubj‚)rÇ}rÈ(jIX``$PROJECT_DIR/cabal.config``jO}rÉ(jQ]jR]jS]jT]jV]ujJj™jD]rÊjbX$PROJECT_DIR/cabal.configrË…rÌ}rÍ(jIUjJjÇubajMjŠubjbX#). The error can be squelched with rÎ…rÏ}rÐ(jIX#). The error can be squelched with jKNjXNjYhjJj™ubj‚)rÑ}rÒ(jIX``--no-require-sandbox``jO}rÓ(jQ]jR]jS]jT]jV]ujJj™jD]rÔjbX--no-require-sandboxrÕ…rÖ}r×(jIUjJjÑubajMjŠubjbX.…rØ}rÙ(jIX.jKNjXNjYhjJj™ubeubjy)rÚ}rÛ(jIXThe 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:jJjÛjKjLjMj|jO}rÜ(jQ]jR]jS]jT]jV]ujXMijYhjD]rÝ(jbX The option rÞ…rß}rà(jIX The option jKNjXNjYhjJjÚubj‚)rá}râ(jIX``--sandbox-config-file``jO}rã(jQ]jR]jS]jT]jV]ujJjÚjD]räjbX--sandbox-config-filerå…ræ}rç(jIUjJjáubajMjŠubjbX' allows to specify the location of the rè…ré}rê(jIX' allows to specify the location of the jKNjXNjYhjJjÚubj‚)rë}rì(jIX``cabal.sandbox.config``jO}rí(jQ]jR]jS]jT]jV]ujJjÚjD]rîjbXcabal.sandbox.configrï…rð}rñ(jIUjJjëubajMjŠubjbX file (by default, rò…ró}rô(jIX file (by default, jKNjXNjYhjJjÚubj‚)rõ}rö(jIX ``cabal``jO}r÷(jQ]jR]jS]jT]jV]ujJjÚjD]røjbXcabalrù…rú}rû(jIUjJjõubajMjŠubjbX” 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þ(jIX” searches for it in the current directory). This provides the same functionality as shared sandboxes, but sometimes can be more convenient. Example:jKNjXNjYhjJjÚubeubj¶)rÿ}r(jIXT$ 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 sandboxjJjÛjKjLjMj¹jO}r(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]rjbXT$ 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(jIUjJjÿubaubjy)r}r(jIXdThe sandbox config file can be also specified via the ``CABAL_SANDBOX_CONFIG`` environment variable.jJjÛjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMzjYhjD]r (jbX6The sandbox config file can be also specified via the r …r }r (jIX6The sandbox config file can be also specified via the jKNjXNjYhjJjubj‚)r }r(jIX``CABAL_SANDBOX_CONFIG``jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXCABAL_SANDBOX_CONFIGr…r}r(jIUjJj ubajMjŠubjbX environment variable.r…r}r(jIX environment variable.jKNjXNjYhjJjubeubjy)r}r(jIXWFinally, the flag ``--ignore-sandbox`` lets you temporarily ignore an existing sandbox:jJjÛjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM}jYhjD]r(jbXFinally, the flag r…r}r(jIXFinally, the flag jKNjXNjYhjJjubj‚)r}r(jIX``--ignore-sandbox``jO}r (jQ]jR]jS]jT]jV]ujJjjD]r!jbX--ignore-sandboxr"…r#}r$(jIUjJjubajMjŠubjbX1 lets you temporarily ignore an existing sandbox:r%…r&}r'(jIX1 lets you temporarily ignore an existing sandbox:jKNjXNjYhjJjubeubj¶)r(}r)(jIXš$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cabal --ignore-sandbox install text # Installs 'text' in the user package database ('~/.cabal').jJjÛjKjLjMj¹jO}r*(j½j¾jT]jS]jQ]jR]jV]ujXM‚jYhjD]r+jbXš$ 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.(jIUjJj(ubaubeubeubjF)r/}r0(jIUjJjçjKjLjMjNjO}r1(jQ]jR]jS]jT]r2h¿ajV]r3haujXM‰jYhjD]r4(j[)r5}r6(jIXCreating a binary packager7jJj/jKjLjMj_jO}r8(jQ]jR]jS]jT]jV]ujXM‰jYhjD]r9jbXCreating a binary packager:…r;}r<(jIj7jKNjXNjYhjJj5ubaubjy)r=}r>(jIX 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?jJj/jKjLjMj|jO}r@(jQ]jR]jS]jT]jV]ujXM‹jYhjD]rAjbX 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:rB…rC}rD(jIj?jKNjXNjYhjJj=ubaubj¶)rE}rF(jIX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/jJj/jKjLjMj¹jO}rG(j½j¾jT]jS]jQ]jR]jV]ujXM‘jYhjD]rHjbX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/rI…rJ}rK(jIUjJjEubaubjy)rL}rM(jIXAIf the package contains a library, you need two additional steps:rNjJj/jKjLjMj|jO}rO(jQ]jR]jS]jT]jV]ujXM–jYhjD]rPjbXAIf the package contains a library, you need two additional steps:rQ…rR}rS(jIjNjKNjXNjYhjJjLubaubj¶)rT}rU(jIXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptjJj/jKjLjMj¹jO}rV(j½j¾jT]jS]jQ]jR]jV]ujXMšjYhjD]rWjbXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptrX…rY}rZ(jIUjJjTubaubjy)r[}r\(jIXfThis 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.jJj/jKjLjMj|jO}r](jQ]jR]jS]jT]jV]ujXMjYhjD]r^(jbXThis creates shell scripts r_…r`}ra(jIXThis creates shell scripts jKNjXNjYhjJj[ubj‚)rb}rc(jIX``register.sh``jO}rd(jQ]jR]jS]jT]jV]ujJj[jD]rejbX register.shrf…rg}rh(jIUjJjbubajMjŠubjbX and ri…rj}rk(jIX and jKNjXNjYhjJj[ubj‚)rl}rm(jIX``unregister.sh``jO}rn(jQ]jR]jS]jT]jV]ujJj[jD]rojbX unregister.shrp…rq}rr(jIUjJjlubajMjŠubjbXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the rs…rt}ru(jIXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the jKNjXNjYhjJj[ubj‚)rv}rw(jIX``register.sh``jO}rx(jQ]jR]jS]jT]jV]ujJj[jD]ryjbX register.shrz…r{}r|(jIUjJjvubajMjŠubjbX script. The r}…r~}r(jIX script. The jKNjXNjYhjJj[ubj‚)r€}r(jIX``unregister.sh``jO}r‚(jQ]jR]jS]jT]jV]ujJj[jD]rƒjbX unregister.shr„…r…}r†(jIUjJj€ubajMjŠubjbX„ 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‰(jIX„ script would be used in the uninstall procedure of the package. Similar steps may be used for creating binary packages for Windows.jKNjXNjYhjJj[ubeubjy)rŠ}r‹(jIX5The following options are understood by all commands:rŒjJj/jKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM¤jYhjD]rŽjbX5The following options are understood by all commands:r…r}r‘(jIjŒjKNjXNjYhjJjŠubaubcsphinx.addnodes index r’)r“}r”(jIUjJj/jKjLjMUindexr•jO}r–(jT]jS]jQ]jR]jV]Uentries]r—(Upairr˜X+setup command line option; --help, -h or -?håUNtr™aujXNjYhjD]ubcsphinx.addnodes desc rš)r›}rœ(jIUjJj/jKjLjMUdescrjO}rž(UnoindexrŸ‰Udomainr XstdjT]jS]jQ]jR]jV]Uobjtyper¡Xoptionr¢Udesctyper£j¢ujXNjYhjD]r¤(csphinx.addnodes desc_signature r¥)r¦}r§(jIX--help, -h or -?jJj›jKjLjMUdesc_signaturer¨jO}r©(Uallnamesrª]r«(X--helpr¬X-hr­ejT]r®håajS]jQ]jR]jV]r¯(hh>eUfirstr°‰ujXM«jYhjD]r±(csphinx.addnodes desc_name r²)r³}r´(jIj¬jJj¦jKjLjMU desc_namerµjO}r¶(j½j¾jT]jS]jQ]jR]jV]ujXM«jYhjD]r·jbX--helpr¸…r¹}rº(jIUjKNjXNjYhjJj³ubaubcsphinx.addnodes desc_addname r»)r¼}r½(jIUjJj¦jKjLjMU desc_addnamer¾jO}r¿(j½j¾jT]jS]jQ]jR]jV]ujXM«jYhjD]ubj»)rÀ}rÁ(jIU, rÂjJj¦jKjLjMj¾jO}rÃ(j½j¾jT]jS]jQ]jR]jV]ujXM«jYhjD]rÄjbX, rÅ…rÆ}rÇ(jIUjKNjXNjYhjJjÀubaubj²)rÈ}rÉ(jIj­jJj¦jKjLjMjµjO}rÊ(j½j¾jT]jS]jQ]jR]jV]ujXM«jYhjD]rËjbX-hrÌ…rÍ}rÎ(jIUjKNjXNjYhjJjÈubaubj»)rÏ}rÐ(jIX or -?jJj¦jKjLjMj¾jO}rÑ(j½j¾jT]jS]jQ]jR]jV]ujXM«jYhjD]rÒjbX or -?rÓ…rÔ}rÕ(jIUjKNjXNjYhjJjÏubaubeubcsphinx.addnodes desc_content rÖ)r×}rØ(jIUjJj›jKjLjMU desc_contentrÙjO}rÚ(jQ]jR]jS]jT]jV]ujXM«jYhjD]rÛjy)rÜ}rÝ(jIX+List the available options for the command.rÞjJj×jKjLjMj|jO}rß(jQ]jR]jS]jT]jV]ujXMªjYhjD]ràjbX+List the available options for the command.rá…râ}rã(jIjÞjKNjXNjYhjJjÜubaubaubeubj’)rä}rå(jIUjJj/jKjLjMj•jO}ræ(jT]jS]jQ]jR]jV]Uentries]rç(j˜X.setup command line option; --verbose=n or -v njAUNtrèaujXNjYhjD]ubjš)ré}rê(jIUjJj/jKjLjMjjO}rë(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrìj£jìujXNjYhjD]rí(j¥)rî}rï(jIX--verbose=n or -v njJjéjKjLjMj¨jO}rð(jª]rñX --verboseròajT]rójAajS]jQ]jR]jV]rôh¡aj°‰ujXM¹jYhjD]rõ(j²)rö}r÷(jIjòjJjîjKjLjMjµjO}rø(j½j¾jT]jS]jQ]jR]jV]ujXM¹jYhjD]rùjbX --verboserú…rû}rü(jIUjKNjXNjYhjJjöubaubj»)rý}rþ(jIX =n or -v njJjîjKjLjMj¾jO}rÿ(j½j¾jT]jS]jQ]jR]jV]ujXM¹jYhjD]rjbX =n or -v nr…r}r(jIUjKNjXNjYhjJjýubaubeubjÖ)r}r(jIUjJjéjKjLjMjÙjO}r(jQ]jR]jS]jT]jV]ujXM¹jYhjD]r(jy)r}r (jIXRSet the verbosity level (0-3). The normal level is 1; a missing *n* defaults to 2.jJjjKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXM®jYhjD]r (jbX@Set the verbosity level (0-3). The normal level is 1; a missing r …r }r(jIX@Set the verbosity level (0-3). The normal level is 1; a missing jKNjXNjYhjJjubj½)r}r(jIX*n*jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXn…r}r(jIUjJjubajMjÅubjbX defaults to 2.r…r}r(jIX defaults to 2.jKNjXNjYhjJjubeubjy)r}r(jIXÅ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.)jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM±jYhjD]r(jbX}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(jIX}There is also an extended version of this command which can be used to fine-tune the verbosity of output. It takes the form jKNjXNjYhjJjubj‚)r}r (jIX!``[silent|normal|verbose|debug]``jO}r!(jQ]jR]jS]jT]jV]ujJjjD]r"jbX[silent|normal|verbose|debug]r#…r$}r%(jIUjJjubajMjŠubjbX…r&}r'(jIX\ jKNjXNjYhjJjubj½)r(}r)(jIX*flags*jO}r*(jQ]jR]jS]jT]jV]ujJjjD]r+jbXflagsr,…r-}r.(jIUjJj(ubajMjÅubjbX, where r/…r0}r1(jIX, where jKNjXNjYhjJjubj½)r2}r3(jIX*flags*jO}r4(jQ]jR]jS]jT]jV]ujJjjD]r5jbXflagsr6…r7}r8(jIUjJj2ubajMjÅubjbX is a list of r9…r:}r;(jIX is a list of jKNjXNjYhjJjubj‚)r<}r=(jIX``+``jO}r>(jQ]jR]jS]jT]jV]ujJjjD]r?jbX+…r@}rA(jIUjJj<ubajMjŠubjbXD flags which toggle various aspects of output. At the moment, only rB…rC}rD(jIXD flags which toggle various aspects of output. At the moment, only jKNjXNjYhjJjubj‚)rE}rF(jIX ``+callsite``jO}rG(jQ]jR]jS]jT]jV]ujJjjD]rHjbX +callsiterI…rJ}rK(jIUjJjEubajMjŠubjbX and rL…rM}rN(jIX and jKNjXNjYhjJjubj‚)rO}rP(jIX``+callstack``jO}rQ(jQ]jR]jS]jT]jV]ujJjjD]rRjbX +callstackrS…rT}rU(jIUjJjOubajMjŠubjbX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)rV…rW}rX(jIX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)jKNjXNjYhjJjubeubeubeubjy)rY}rZ(jIX£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.r[jJj/jKjLjMj|jO}r\(jQ]jR]jS]jT]jV]ujXMºjYhjD]r]jbX£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.r^…r_}r`(jIj[jKNjXNjYhjJjYubaubjá)ra}rb(jIX.. _setup-configure:jJj/jKjLjMjäjO}rc(jT]jS]jQ]jR]jV]jæjujXM¾jYhjD]ubeubjF)rd}re(jIUU referencedrfKjJjçjKjLjé}rghwjasjMjNjO}rh(jQ]jR]jS]jT]ri(jj&ejV]rj(h…hweujXMÁjYhjî}rkjjasjD]rl(j[)rm}rn(jIXsetup configurerojJjdjKjLjMj_jO}rp(jQ]jR]jS]jT]jV]ujXMÁjYhjD]rqjbXsetup configurerr…rs}rt(jIjojKNjXNjYhjJjmubaubjy)ru}rv(jIXÁ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.rwjJjdjKjLjMj|jO}rx(jQ]jR]jS]jT]jV]ujXMÅjYhjD]ryjbXÁ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.rz…r{}r|(jIjwjKNjXNjYhjJjuubaubjy)r}}r~(jIXì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.rjJjdjKjLjMj|jO}r€(jQ]jR]jS]jT]jV]ujXMÉjYhjD]rjbXì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.r‚…rƒ}r„(jIjjKNjXNjYhjJj}ubaubjy)r…}r†(jIXkIf 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.jJjdjKjLjMj|jO}r‡(jQ]jR]jS]jT]jV]ujXMÎjYhjD]rˆ(jbXIf a user-supplied r‰…rŠ}r‹(jIXIf a user-supplied jKNjXNjYhjJj…ubj‚)rŒ}r(jIX ``configure``jO}rŽ(jQ]jR]jS]jT]jV]ujJj…jD]rjbX configurer…r‘}r’(jIUjJjŒubajMjŠubjbX# script is run (see the section on r“…r”}r•(jIX# script is run (see the section on jKNjXNjYhjJj…ubjœ)r–}r—(jIXV`system-dependent parameters `__jO}r˜(UnameXsystem-dependent parametersjêX4developing-packages.html#system-dependent-parametersjT]jS]jQ]jR]jV]ujJj…jD]r™jbXsystem-dependent parametersrš…r›}rœ(jIUjJj–ubajMj¥ubjbX or on r…rž}rŸ(jIX or on jKNjXNjYhjJj…ubjœ)r }r¡(jIXE`complex packages `__jO}r¢(UnameXcomplex packagesjêX.developing-packages.html#more-complex-packagesjT]jS]jQ]jR]jV]ujJj…jD]r£jbXcomplex packagesr¤…r¥}r¦(jIUjJj ubajMj¥ubjbX), it is passed the r§…r¨}r©(jIX), it is passed the jKNjXNjYhjJj…ubj­)rª}r«(jIX:option:`--with-hc-pkg`r¬jJj…jKjLjMj±jO}r­(UreftypeXoptionj³ˆj´X --with-hc-pkgU refdomainXstdr®jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸Xsetup-configurer¯ujXMÎjD]r°j‚)r±}r²(jIj¬jO}r³(jQ]jR]r´(j¾j®X std-optionrµejS]jT]jV]ujJjªjD]r¶jbX --with-hc-pkgr·…r¸}r¹(jIUjJj±ubajMjŠubaubjbX, rº…r»}r¼(jIX, r½jKNjXNjYhjJj…ubj­)r¾}r¿(jIX:option:`--prefix`rÀjJj…jKjLjMj±jO}rÁ(UreftypeXoptionj³ˆj´X--prefixU refdomainXstdrÂjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rÃj‚)rÄ}rÅ(jIjÀjO}rÆ(jQ]jR]rÇ(j¾jÂX std-optionrÈejS]jT]jV]ujJj¾jD]rÉjbX--prefixrÊ…rË}rÌ(jIUjJjÄubajMjŠubaubjbX, rÍ…rÎ}rÏ(jIX, jJj…ubj­)rÐ}rÑ(jIX:option:`--bindir`rÒjJj…jKjLjMj±jO}rÓ(UreftypeXoptionj³ˆj´X--bindirU refdomainXstdrÔjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rÕj‚)rÖ}r×(jIjÒjO}rØ(jQ]jR]rÙ(j¾jÔX std-optionrÚejS]jT]jV]ujJjÐjD]rÛjbX--bindirrÜ…rÝ}rÞ(jIUjJjÖubajMjŠubaubjbX, rß…rà}rá(jIX, jKNjXNjYhjJj…ubj­)râ}rã(jIX:option:`--libdir`räjJj…jKjLjMj±jO}rå(UreftypeXoptionj³ˆj´X--libdirU refdomainXstdræjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rçj‚)rè}ré(jIjäjO}rê(jQ]jR]rë(j¾jæX std-optionrìejS]jT]jV]ujJjâjD]ríjbX--libdirrî…rï}rð(jIUjJjèubajMjŠubaubjbX, rñ…rò}ró(jIX, jJj…ubj­)rô}rõ(jIX:option:`--dynlibdir`röjJj…jKjLjMj±jO}r÷(UreftypeXoptionj³ˆj´X --dynlibdirU refdomainXstdrøjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rùj‚)rú}rû(jIjöjO}rü(jQ]jR]rý(j¾jøX std-optionrþejS]jT]jV]ujJjôjD]rÿjbX --dynlibdirr …r }r (jIUjJjúubajMjŠubaubjbX, r …r }r (jIX, jJj…ubj­)r }r (jIX:option:`--datadir`r jJj…jKjLjMj±jO}r (UreftypeXoptionj³ˆj´X --datadirU refdomainXstdr jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]r j‚)r }r (jIj jO}r (jQ]jR]r (j¾j X std-optionr ejS]jT]jV]ujJj jD]r jbX --datadirr …r }r (jIUjJj ubajMjŠubaubjbX, r …r }r (jIj½jJj…ubj­)r }r (jIX:option:`--libexecdir`r jJj…jKjLjMj±jO}r (UreftypeXoptionj³ˆj´X --libexecdirU refdomainXstdr jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]r j‚)r }r (jIj jO}r (jQ]jR]r! (j¾j X std-optionr" ejS]jT]jV]ujJj jD]r# jbX --libexecdirr$ …r% }r& (jIUjJj ubajMjŠubaubjbX and r' …r( }r) (jIX and jKNjXNjYhjJj…ubj­)r* }r+ (jIX:option:`--sysconfdir`r, jJj…jKjLjMj±jO}r- (UreftypeXoptionj³ˆj´X --sysconfdirU refdomainXstdr. jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]r/ j‚)r0 }r1 (jIj, jO}r2 (jQ]jR]r3 (j¾j. X std-optionr4 ejS]jT]jV]ujJj* jD]r5 jbX --sysconfdirr6 …r7 }r8 (jIUjJj0 ubajMjŠubaubjbX' options. In addition the value of the r9 …r: }r; (jIX' options. In addition the value of the jKNjXNjYhjJj…ubj­)r< }r= (jIX:option:`--with-compiler`r> jJj…jKjLjMj±jO}r? (UreftypeXoptionj³ˆj´X--with-compilerU refdomainXstdr@ jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rA j‚)rB }rC (jIj> jO}rD (jQ]jR]rE (j¾j@ X std-optionrF ejS]jT]jV]ujJj< jD]rG jbX--with-compilerrH …rI }rJ (jIUjJjB ubajMjŠubaubjbX option is passed in a rK …rL }rM (jIX option is passed in a jKNjXNjYhjJj…ubj­)rN }rO (jIX:option:`--with-hc-pkg`rP jJj…jKjLjMj±jO}rQ (UreftypeXoptionj³ˆj´X --with-hc-pkgU refdomainXstdrR jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]rS j‚)rT }rU (jIjP jO}rV (jQ]jR]rW (j¾jR X std-optionrX ejS]jT]jV]ujJjN jD]rY jbX --with-hc-pkgrZ …r[ }r\ (jIUjJjT ubajMjŠubaubjbX' option and all options specified with r] …r^ }r_ (jIX' option and all options specified with jKNjXNjYhjJj…ubj­)r` }ra (jIX:option:`--configure-option`rb jJj…jKjLjMj±jO}rc (UreftypeXoptionj³ˆj´X--configure-optionU refdomainXstdrd jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÎjD]re j‚)rf }rg (jIjb jO}rh (jQ]jR]ri (j¾jd X std-optionrj ejS]jT]jV]ujJj` jD]rk jbX--configure-optionrl …rm }rn (jIUjJjf ubajMjŠubaubjbX are passed on.ro …rp }rq (jIX are passed on.jKNjXNjYhjJj…ubeubjy)rr }rs (jIX}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:jJjdjKjLjMj|jO}rt (jQ]jR]jS]jT]jV]ujXMÙjYhjD]ru (jbXDIn Cabal 2.0, support for a single positional argument was added to rv …rw }rx (jIXDIn Cabal 2.0, support for a single positional argument was added to jKNjXNjYhjJjr ubj‚)ry }rz (jIX``setup configure``jO}r{ (jQ]jR]jS]jT]jV]ujJjr jD]r| jbXsetup configurer} …r~ }r (jIUjJjy ubajMjŠubjbXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with r€ …r }r‚ (jIXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with jKNjXNjYhjJjr ubj‚)rƒ }r„ (jIX``lib:``jO}r… (jQ]jR]jS]jT]jV]ujJjr jD]r† jbXlib:r‡ …rˆ }r‰ (jIUjJjƒ ubajMjŠubjbX or rŠ …r‹ }rŒ (jIX or jKNjXNjYhjJjr ubj‚)r }rŽ (jIX``exe:``jO}r (jQ]jR]jS]jT]jV]ujJjr jD]r jbXexe:r‘ …r’ }r“ (jIUjJj ubajMjŠubjbXL in case just a name is ambiguous (as would be the case for a package named r” …r• }r– (jIXL in case just a name is ambiguous (as would be the case for a package named jKNjXNjYhjJjr ubj‚)r— }r˜ (jIX``p``jO}r™ (jQ]jR]jS]jT]jV]ujJjr jD]rš jbXp…r› }rœ (jIUjJj— ubajMjŠubjbX- which has a library and an executable named r …rž }rŸ (jIX- which has a library and an executable named jKNjXNjYhjJjr ubj‚)r  }r¡ (jIX``p``jO}r¢ (jQ]jR]jS]jT]jV]ujJjr jD]r£ jbXp…r¤ }r¥ (jIUjJj  ubajMjŠubjbX".) This has the following effects:r¦ …r§ }r¨ (jIX".) This has the following effects:jKNjXNjYhjJjr ubeubcdocutils.nodes bullet_list r© )rª }r« (jIUjJjdjKjLjMU bullet_listr¬ jO}r­ (Ubulletr® X-jT]jS]jQ]jR]jV]ujXMàjYhjD]r¯ (cdocutils.nodes list_item r° )r± }r² (jIXhSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component. jJjª jKjLjMU list_itemr³ jO}r´ (jQ]jR]jS]jT]jV]ujXNjYhjD]rµ jy)r¶ }r· (jIXgSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component.jJj± jKjLjMj|jO}r¸ (jQ]jR]jS]jT]jV]ujXMàjD]r¹ (jbXSubsequent invocations of rº …r» }r¼ (jIXSubsequent invocations of jJj¶ ubj‚)r½ }r¾ (jIX``cabal build``jO}r¿ (jQ]jR]jS]jT]jV]ujJj¶ jD]rÀ jbX cabal buildrÁ …r }rà (jIUjJj½ ubajMjŠubjbX, rÄ …rÅ }rÆ (jIX, jJj¶ ubj‚)rÇ }rÈ (jIX ``register``jO}rÉ (jQ]jR]jS]jT]jV]ujJj¶ jD]rÊ jbXregisterrË …rÌ }rÍ (jIUjJjÇ ubajMjŠubjbX0, etc. operate only on the configured component.rÎ …rÏ }rÐ (jIX0, etc. operate only on the configured component.jJj¶ ubeubaubj° )rÑ }rÒ (jIXð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``. jJjª jKjLjMj³ jO}rÓ (jQ]jR]jS]jT]jV]ujXNjYhjD]rÔ jy)rÕ }rÖ (jIXï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``.jJjÑ jKjLjMj|jO}r× (jQ]jR]jS]jT]jV]ujXMãjD]rØ (jbX¢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Û (jIXž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 jJjÕ ubj­)rÜ }rÝ (jIX:option:`--package-db`rÞ jJjÕ jKjLjMj±jO}rß (UreftypeXoptionj³ˆj´X --package-dbU refdomainXstdrà jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMãjD]rá j‚)râ }rã (jIjÞ jO}rä (jQ]jR]rå (j¾jà X std-optionræ ejS]jT]jV]ujJjÜ jD]rç jbX --package-dbrè …ré }rê (jIUjJjâ ubajMjŠubaubjbXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using rë …rì }rí (jIXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using jJjÕ ubj­)rî }rï (jIX:option:`--dependency`rð jJjÕ jKjLjMj±jO}rñ (UreftypeXoptionj³ˆj´X --dependencyU refdomainXstdrò jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMãjD]ró j‚)rô }rõ (jIjð jO}rö (jQ]jR]r÷ (j¾jò X std-optionrø ejS]jT]jV]ujJjî jD]rù jbX --dependencyrú …rû }rü (jIUjJjô ubajMjŠubaubjbXg simply by giving the name of the internal library; e.g., the dependency for an internal library named rý …rþ }rÿ (jIXg simply by giving the name of the internal library; e.g., the dependency for an internal library named jJjÕ ubj‚)r }r (jIX``foo``jO}r (jQ]jR]jS]jT]jV]ujJjÕ jD]r jbXfoor …r }r (jIUjJj ubajMjŠubjbX is given as r …r }r (jIX is given as jJjÕ ubj‚)r }r (jIX3``--dependency=pkg-internal=pkg-1.0-internal-abcd``jO}r (jQ]jR]jS]jT]jV]ujJjÕ jD]r jbX/--dependency=pkg-internal=pkg-1.0-internal-abcdr …r }r (jIUjJj ubajMjŠubjbX.…r }r (jIX.jJjÕ ubeubaubj° )r }r (jIXOnly 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.) jJjª jKjLjMj³ jO}r (jQ]jR]jS]jT]jV]ujXNjYhjD]r jy)r }r (jIXOnly 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.)jJj jKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXMìjD]r (jbXWOnly the dependencies needed for the requested component are required. Similarly, when r …r }r (jIXWOnly the dependencies needed for the requested component are required. Similarly, when jJj ubj­)r }r (jIX:option:`--exact-configuration`r jJj jKjLjMj±jO}r! (UreftypeXoptionj³ˆj´X--exact-configurationU refdomainXstdr" jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMìjD]r# j‚)r$ }r% (jIj jO}r& (jQ]jR]r' (j¾j" X std-optionr( ejS]jT]jV]ujJj jD]r) jbX--exact-configurationr* …r+ }r, (jIUjJj$ ubajMjŠubaubjbX0 is specified, it’s only necessary to specify r- …r. }r/ (jIX. is specified, it's only necessary to specify jJj ubj­)r0 }r1 (jIX:option:`--dependency`r2 jJj jKjLjMj±jO}r3 (UreftypeXoptionj³ˆj´X --dependencyU refdomainXstdr4 jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMìjD]r5 j‚)r6 }r7 (jIj2 jO}r8 (jQ]jR]r9 (j¾j4 X std-optionr: ejS]jT]jV]ujJj0 jD]r; jbX --dependencyr< …r= }r> (jIUjJj6 ubajMjŠubaubjbX2 for the component. (As mentioned previously, you r? …r@ }rA (jIX2 for the component. (As mentioned previously, you jJj ubj½)rB }rC (jIX*must*jO}rD (jQ]jR]jS]jT]jV]ujJj jD]rE jbXmustrF …rG }rH (jIUjJjB ubajMjÅubjbX( specify internal dependencies as well.)rI …rJ }rK (jIX( specify internal dependencies as well.)jJj ubeubaubj° )rL }rM (jIXŽInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``. jJjª jKjLjMj³ jO}rN (jQ]jR]jS]jT]jV]ujXNjYhjD]rO jy)rP }rQ (jIXInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``.jJjL jKjLjMj|jO}rR (jQ]jR]jS]jT]jV]ujXMòjD]rS (jbX Internal rT …rU }rV (jIX Internal jJjP ubj‚)rW }rX (jIX``build-tool-depends``jO}rY (jQ]jR]jS]jT]jV]ujJjP jD]rZ jbXbuild-tool-dependsr[ …r\ }r] (jIUjJjW ubajMjŠubjbX and r^ …r_ }r` (jIX and jJjP ubj‚)ra }rb (jIX``build-tools``jO}rc (jQ]jR]jS]jT]jV]ujJjP jD]rd jbX build-toolsre …rf }rg (jIUjJja ubajMjŠubjbX( dependencies are expected to be in the rh …ri }rj (jIX( dependencies are expected to be in the jJjP ubj‚)rk }rl (jIX``PATH``jO}rm (jQ]jR]jS]jT]jV]ujJjP jD]rn jbXPATHro …rp }rq (jIUjJjk ubajMjŠubjbX upon subsequent invocations of rr …rs }rt (jIX upon subsequent invocations of jJjP ubj‚)ru }rv (jIX ``setup``jO}rw (jQ]jR]jS]jT]jV]ujJjP jD]rx jbXsetupry …rz }r{ (jIUjJju ubajMjŠubjbX.…r| }r} (jIX.jJjP ubeubaubeubjy)r~ }r (jIXŸFull details can be found in the `Componentized Cabal proposal `__.jJjdjKjLjMj|jO}r€ (jQ]jR]jS]jT]jV]ujXMõjYhjD]r (jbX!Full details can be found in the r‚ …rƒ }r„ (jIX!Full details can be found in the jKNjXNjYhjJj~ ubjœ)r… }r† (jIX}`Componentized Cabal proposal `__jO}r‡ (UnameXComponentized Cabal proposaljêXZhttps://github.com/ezyang/ghc-proposals/blob/master/proposals/0000-componentized-cabal.rstjT]jS]jQ]jR]jV]ujJj~ jD]rˆ jbXComponentized Cabal proposalr‰ …rŠ }r‹ (jIUjJj… ubajMj¥ubjbX.…rŒ }r (jIX.jKNjXNjYhjJj~ ubeubjF)rŽ }r (jIUjJjdjKjLjMjNjO}r (jQ]jR]jS]jT]r‘ hæajV]r’ h?aujXMùjYhjD]r“ (j[)r” }r• (jIXPrograms used for buildingr– jJjŽ jKjLjMj_jO}r— (jQ]jR]jS]jT]jV]ujXMùjYhjD]r˜ jbXPrograms used for buildingr™ …rš }r› (jIj– jKNjXNjYhjJj” ubaubjy)rœ }r (jIXXThe following options govern the programs used to process the source files of a package:rž jJjŽ jKjLjMj|jO}rŸ (jQ]jR]jS]jT]jV]ujXMûjYhjD]r  jbXXThe following options govern the programs used to process the source files of a package:r¡ …r¢ }r£ (jIjž jKNjXNjYhjJjœ ubaubj’)r¤ }r¥ (jIUjJjŽ jKjLjMj•jO}r¦ (jT]jS]jQ]jR]jV]Uentries]r§ (j˜XEsetup-configure command line option; --ghc or -g, --jhc, --lhc, --uhch±UNtr¨ aujXNjYhjD]ubjš)r© }rª (jIUjJjŽ jKjLjMjjO}r« (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr¬ j£j¬ ujXNjYhjD]r­ (j¥)r® }r¯ (jIX --ghc or -g, --jhc, --lhc, --uhcjJj© jKjLjMj¨jO}r° (jª]r± (X--ghcr² X--jhcr³ X--lhcr´ X--uhcrµ ejT]r¶ h±ajS]jQ]jR]jV]r· (h hƒhyhBej°‰ujXMjYhjD]r¸ (j²)r¹ }rº (jIj² jJj® jKjLjMjµjO}r» (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r¼ jbX--ghcr½ …r¾ }r¿ (jIUjKNjXNjYhjJj¹ ubaubj»)rÀ }rÁ (jIX or -gjJj® jKjLjMj¾jO}r (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rà jbX or -grÄ …rÅ }rÆ (jIUjKNjXNjYhjJjÀ ubaubj»)rÇ }rÈ (jIjÂjJj® jKjLjMj¾jO}rÉ (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÊ jbX, rË …rÌ }rÍ (jIUjKNjXNjYhjJjÇ ubaubj²)rÎ }rÏ (jIj³ jJj® jKjLjMjµjO}rÐ (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÑ jbX--jhcrÒ …rÓ }rÔ (jIUjKNjXNjYhjJjÎ ubaubj»)rÕ }rÖ (jIUjJj® jKjLjMj¾jO}r× (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubj»)rØ }rÙ (jIjÂjJj® jKjLjMj¾jO}rÚ (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÛ jbX, rÜ …rÝ }rÞ (jIUjKNjXNjYhjJjØ ubaubj²)rß }rà (jIj´ jJj® jKjLjMjµjO}rá (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]râ jbX--lhcrã …rä }rå (jIUjKNjXNjYhjJjß ubaubj»)ræ }rç (jIUjJj® jKjLjMj¾jO}rè (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubj»)ré }rê (jIjÂjJj® jKjLjMj¾jO}rë (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rì jbX, rí …rî }rï (jIUjKNjXNjYhjJjé ubaubj²)rð }rñ (jIjµ jJj® jKjLjMjµjO}rò (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ró jbX--uhcrô …rõ }rö (jIUjKNjXNjYhjJjð ubaubj»)r÷ }rø (jIUjJj® jKjLjMj¾jO}rù (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubeubjÖ)rú }rû (jIUjJj© jKjLjMjÙjO}rü (jQ]jR]jS]jT]jV]ujXMjYhjD]rý jy)rþ }rÿ (jIXÑ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 jJjú jKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXMjYhjD]r jbXÑ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 (jIj jKNjXNjYhjJjþ ubaubaubeubj’)r }r (jIUjJjŽ jKjLjMj•jO}r (jT]jS]jQ]jR]jV]Uentries]r (j˜XFsetup-configure command line option; --with-compiler=path or -w *path*hÌUNtr aujXNjYhjD]ubjš)r }r (jIUjJjŽ jKjLjMjjO}r (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr j£j ujXNjYhjD]r (j¥)r }r (jIX!--with-compiler=path or -w *path*jJj jKjLjMj¨jO}r (jª]r X--with-compilerr ajT]r hÌajS]jQ]jR]jV]r h%aj°‰ujXMjYhjD]r (j²)r }r (jIj jJj jKjLjMjµjO}r (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r jbX--with-compilerr …r }r (jIUjKNjXNjYhjJj ubaubj»)r }r (jIX=path or -w *path*jJj jKjLjMj¾jO}r! (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r" jbX=path or -w *path*r# …r$ }r% (jIUjKNjXNjYhjJj ubaubeubjÖ)r& }r' (jIUjJj jKjLjMjÙjO}r( (jQ]jR]jS]jT]jV]ujXMjYhjD]r) (jy)r* }r+ (jIX³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, jJj& jKjLjMj|jO}r- (jQ]jR]jS]jT]jV]ujXMjYhjD]r. jbX³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/ …r0 }r1 (jIj, jKNjXNjYhjJj* ubaubjy)r2 }r3 (jIXù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).jJj& jKjLjMj|jO}r4 (jQ]jR]jS]jT]jV]ujXM jYhjD]r5 (jbX-This flag also sets the default value of the r6 …r7 }r8 (jIX-This flag also sets the default value of the jKNjXNjYhjJj2 ubj­)r9 }r: (jIX:option:`--with-hc-pkg`r; jJj2 jKjLjMj±jO}r< (UreftypeXoptionj³ˆj´X --with-hc-pkgU refdomainXstdr= jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM jD]r> j‚)r? }r@ (jIj; jO}rA (jQ]jR]rB (j¾j= X std-optionrC ejS]jT]jV]ujJj9 jD]rD jbX --with-hc-pkgrE …rF }rG (jIUjJj? ubajMjŠubaubjbXC option to the package tool for this compiler. Check the output of rH …rI }rJ (jIXC option to the package tool for this compiler. Check the output of jKNjXNjYhjJj2 ubj‚)rK }rL (jIX``setup configure -v``jO}rM (jQ]jR]jS]jT]jV]ujJj2 jD]rN jbXsetup configure -vrO …rP }rQ (jIUjJjK ubajMjŠubjbX8 to ensure that it finds the right package tool (or use rR …rS }rT (jIX8 to ensure that it finds the right package tool (or use jKNjXNjYhjJj2 ubj­)rU }rV (jIX:option:`--with-hc-pkg`rW jJj2 jKjLjMj±jO}rX (UreftypeXoptionj³ˆj´X --with-hc-pkgU refdomainXstdrY jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM jD]rZ j‚)r[ }r\ (jIjW jO}r] (jQ]jR]r^ (j¾jY X std-optionr_ ejS]jT]jV]ujJjU jD]r` jbX --with-hc-pkgra …rb }rc (jIUjJj[ ubajMjŠubaubjbX explicitly).rd …re }rf (jIX explicitly).jKNjXNjYhjJj2 ubeubeubeubj’)rg }rh (jIUjJjŽ jKjLjMj•jO}ri (jT]jS]jQ]jR]jV]Uentries]rj (j˜X7setup-configure command line option; --with-hc-pkg=pathhÎUNtrk aujXNjYhjD]ubjš)rl }rm (jIUjJjŽ jKjLjMjjO}rn (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionro j£jo ujXNjYhjD]rp (j¥)rq }rr (jIX--with-hc-pkg=pathjJjl jKjLjMj¨jO}rs (jª]rt X --with-hc-pkgru ajT]rv hÎajS]jQ]jR]jV]rw h'aj°‰ujXMjYhjD]rx (j²)ry }rz (jIju jJjq jKjLjMjµjO}r{ (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r| jbX --with-hc-pkgr} …r~ }r (jIUjKNjXNjYhjJjy ubaubj»)r€ }r (jIX=pathjJjq jKjLjMj¾jO}r‚ (j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rƒ jbX=pathr„ …r… }r† (jIUjKNjXNjYhjJj€ ubaubeubjÖ)r‡ }rˆ (jIUjJjl jKjLjMjÙjO}r‰ (jQ]jR]jS]jT]jV]ujXMjYhjD]rŠ jy)r‹ }rŒ (jIXì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.jJj‡ jKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXMjYhjD]rŽ (jbX+Specify the path to the package tool, e.g. r …r }r‘ (jIX+Specify the path to the package tool, e.g. jKNjXNjYhjJj‹ ubj‚)r’ }r“ (jIX ``ghc-pkg``jO}r” (jQ]jR]jS]jT]jV]ujJj‹ jD]r• jbXghc-pkgr– …r— }r˜ (jIUjJj’ ubajMjŠubjbXE. The package tool must be compatible with the compiler specified by r™ …rš }r› (jIXE. The package tool must be compatible with the compiler specified by jKNjXNjYhjJj‹ ubj­)rœ }r (jIX:option:`--with-compiler`rž jJj‹ jKjLjMj±jO}rŸ (UreftypeXoptionj³ˆj´X--with-compilerU refdomainXstdr  jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]r¡ j‚)r¢ }r£ (jIjž jO}r¤ (jQ]jR]r¥ (j¾j  X std-optionr¦ ejS]jT]jV]ujJjœ jD]r§ jbX--with-compilerr¨ …r© }rª (jIUjJj¢ ubajMjŠubaubjbXX. If this option is omitted, the default value is determined from the compiler selected.r« …r¬ }r­ (jIXX. If this option is omitted, the default value is determined from the compiler selected.jKNjXNjYhjJj‹ ubeubaubeubj’)r® }r¯ (jIUjJjŽ jKjLjMj•jO}r° (jT]jS]jQ]jR]jV]Uentries]r± (j˜X5setup-configure command line option; --with-prog=pathj0UNtr² aujXNjYhjD]ubjš)r³ }r´ (jIUjJjŽ jKjLjMjjO}rµ (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr¶ j£j¶ ujXNjYhjD]r· (j¥)r¸ }r¹ (jIX--with-prog=pathjJj³ jKjLjMj¨jO}rº (jª]r» X --with-progr¼ ajT]r½ j0ajS]jQ]jR]jV]r¾ haj°‰ujXM jYhjD]r¿ (j²)rÀ }rÁ (jIj¼ jJj¸ jKjLjMjµjO}r (j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]rà jbX --with-progrÄ …rÅ }rÆ (jIUjKNjXNjYhjJjÀ ubaubj»)rÇ }rÈ (jIX=pathjJj¸ jKjLjMj¾jO}rÉ (j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]rÊ jbX=pathrË …rÌ }rÍ (jIUjKNjXNjYhjJjÇ ubaubeubjÖ)rÎ }rÏ (jIUjJj³ jKjLjMjÙjO}rÐ (jQ]jR]jS]jT]jV]ujXM jYhjD]rÑ jy)rÒ }rÓ (jIX—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.jJjÎ jKjLjMj|jO}rÔ (jQ]jR]jS]jT]jV]ujXMjYhjD]rÕ (jbX Specify the path to the program rÖ …r× }rØ (jIX Specify the path to the program jKNjXNjYhjJjÒ ubj½)rÙ }rÚ (jIX*prog*jO}rÛ (jQ]jR]jS]jT]jV]ujJjÒ jD]rÜ jbXprogrÝ …rÞ }rß (jIUjJjÙ ubajMjÅubjbX5. Any program known to Cabal can be used in place of rà …rá }râ (jIX5. Any program known to Cabal can be used in place of jKNjXNjYhjJjÒ ubj½)rã }rä (jIX*prog*jO}rå (jQ]jR]jS]jT]jV]ujJjÒ jD]ræ jbXprogrç …rè }ré (jIUjJjã ubajMjÅubjbXt. 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ì (jIXt. It can either be a fully path or the name of a program that can be found on the program search path. For example: jKNjXNjYhjJjÒ ubj‚)rí }rî (jIX``--with-ghc=ghc-6.6.1``jO}rï (jQ]jR]jS]jT]jV]ujJjÒ jD]rð jbX--with-ghc=ghc-6.6.1rñ …rò }ró (jIUjJjí ubajMjŠubjbX or rô …rõ }rö (jIX or jKNjXNjYhjJjÒ ubj‚)r÷ }rø (jIX%``--with-cpphs=/usr/local/bin/cpphs``jO}rù (jQ]jR]jS]jT]jV]ujJjÒ jD]rú jbX!--with-cpphs=/usr/local/bin/cpphsrû …rü }rý (jIUjJj÷ ubajMjŠubjbXW. The full list of accepted programs is not enumerated in this user guide. Rather, run rþ …rÿ }r (jIXW. The full list of accepted programs is not enumerated in this user guide. Rather, run jKNjXNjYhjJjÒ ubj‚)r }r (jIX``cabal install --help``jO}r (jQ]jR]jS]jT]jV]ujJjÒ jD]r jbXcabal install --helpr …r }r (jIUjJj ubajMjŠubjbX to view the list.r …r }r (jIX to view the list.jKNjXNjYhjJjÒ ubeubaubeubj’)r }r (jIUjJjŽ jKjLjMj•jO}r (jT]jS]jQ]jR]jV]Uentries]r (j˜X;setup-configure command line option; --prog-options=optionsjUNtr aujXNjYhjD]ubjš)r }r (jIUjJjŽ jKjLjMjjO}r (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr j£j ujXNjYhjD]r (j¥)r }r (jIX--prog-options=optionsjJj jKjLjMj¨jO}r (jª]r X--prog-optionsr ajT]r jajS]jQ]jR]jV]r hxaj°‰ujXM+jYhjD]r (j²)r }r (jIj jJj jKjLjMjµjO}r (j½j¾jT]jS]jQ]jR]jV]ujXM+jYhjD]r jbX--prog-optionsr! …r" }r# (jIUjKNjXNjYhjJj ubaubj»)r$ }r% (jIX=optionsjJj jKjLjMj¾jO}r& (j½j¾jT]jS]jQ]jR]jV]ujXM+jYhjD]r' jbX=optionsr( …r) }r* (jIUjKNjXNjYhjJj$ ubaubeubjÖ)r+ }r, (jIUjJj jKjLjMjÙjO}r- (jQ]jR]jS]jT]jV]ujXM+jYhjD]r. jy)r/ }r0 (jIX×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.jJj+ jKjLjMj|jO}r1 (jQ]jR]jS]jT]jV]ujXM#jYhjD]r2 (jbX*Specify additional options to the program r3 …r4 }r5 (jIX*Specify additional options to the program jKNjXNjYhjJj/ ubj½)r6 }r7 (jIX*prog*jO}r8 (jQ]jR]jS]jT]jV]ujJj/ jD]r9 jbXprogr: …r; }r< (jIUjJj6 ubajMjÅubjbX5. Any program known to Cabal can be used in place of r= …r> }r? (jIX5. Any program known to Cabal can be used in place of jKNjXNjYhjJj/ ubj½)r@ }rA (jIX*prog*jO}rB (jQ]jR]jS]jT]jV]ujJj/ jD]rC jbXprogrD …rE }rF (jIUjJj@ ubajMjÅubjbX. For example: rG …rH }rI (jIX. For example: jKNjXNjYhjJj/ ubj‚)rJ }rK (jIX.``--alex-options="--template=mytemplatedir/"``jO}rL (jQ]jR]jS]jT]jV]ujJj/ jD]rM jbX*--alex-options="--template=mytemplatedir/"rN …rO }rP (jIUjJjJ ubajMjŠubjbX. The rQ …rR }rS (jIX. The jKNjXNjYhjJj/ ubj½)rT }rU (jIX *options*jO}rV (jQ]jR]jS]jT]jV]ujJj/ jD]rW jbXoptionsrX …rY }rZ (jIUjJjT ubajMjÅubjbXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example r[ …r\ }r] (jIXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example jKNjXNjYhjJj/ ubj‚)r^ }r_ (jIX/``--foo-options='--bar="C:\Program File\Bar"'``jO}r` (jQ]jR]jS]jT]jV]ujJj/ jD]ra jbX+--foo-options='--bar="C:\Program File\Bar"'rb …rc }rd (jIUjJj^ ubajMjŠubjbX[. As an alternative that takes only one option at a time but avoids the need to quote, use re …rf }rg (jIX[. As an alternative that takes only one option at a time but avoids the need to quote, use jKNjXNjYhjJj/ ubj­)rh }ri (jIX:option:`--prog-option`rj jJj/ jKjLjMj±jO}rk (UreftypeXoptionj³ˆj´X --prog-optionU refdomainXstdrl jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM#jD]rm j‚)rn }ro (jIjj jO}rp (jQ]jR]rq (j¾jl X std-optionrr ejS]jT]jV]ujJjh jD]rs jbX --prog-optionrt …ru }rv (jIUjJjn ubajMjŠubaubjbX instead.rw …rx }ry (jIX instead.jKNjXNjYhjJj/ ubeubaubeubj’)rz }r{ (jIUjJjŽ jKjLjMj•jO}r| (jT]jS]jQ]jR]jV]Uentries]r} (j˜X9setup-configure command line option; --prog-option=optionjUNtr~ aujXNjYhjD]ubjš)r }r€ (jIUjJjŽ jKjLjMjjO}r (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr‚ j£j‚ ujXNjYhjD]rƒ (j¥)r„ }r… (jIX--prog-option=optionjJj jKjLjMj¨jO}r† (jª]r‡ X --prog-optionrˆ ajT]r‰ jajS]jQ]jR]jV]rŠ hkaj°‰ujXM4jYhjD]r‹ (j²)rŒ }r (jIjˆ jJj„ jKjLjMjµjO}rŽ (j½j¾jT]jS]jQ]jR]jV]ujXM4jYhjD]r jbX --prog-optionr …r‘ }r’ (jIUjKNjXNjYhjJjŒ ubaubj»)r“ }r” (jIX=optionjJj„ jKjLjMj¾jO}r• (j½j¾jT]jS]jQ]jR]jV]ujXM4jYhjD]r– jbX=optionr— …r˜ }r™ (jIUjKNjXNjYhjJj“ ubaubeubjÖ)rš }r› (jIUjJj jKjLjMjÙjO}rœ (jQ]jR]jS]jT]jV]ujXM4jYhjD]r jy)rž }rŸ (jIX€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"``.jJjš jKjLjMj|jO}r  (jQ]jR]jS]jT]jV]ujXM.jYhjD]r¡ (jbX2Specify a single additional option to the program r¢ …r£ }r¤ (jIX2Specify a single additional option to the program jKNjXNjYhjJjž ubj½)r¥ }r¦ (jIX*prog*jO}r§ (jQ]jR]jS]jT]jV]ujJjž jD]r¨ jbXprogr© …rª }r« (jIUjJj¥ ubajMjÅubjbXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than r¬ …r­ }r® (jIXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than jKNjXNjYhjJjž ubj­)r¯ }r° (jIX:option:`--prog-options`r± jJjž jKjLjMj±jO}r² (UreftypeXoptionj³ˆj´X--prog-optionsU refdomainXstdr³ jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM.jD]r´ j‚)rµ }r¶ (jIj± jO}r· (jQ]jR]r¸ (j¾j³ X std-optionr¹ ejS]jT]jV]ujJj¯ jD]rº jbX--prog-optionsr» …r¼ }r½ (jIUjJjµ ubajMjŠubaubjbX‹ 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À (jIX‹ 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 jKNjXNjYhjJjž ubj‚)rÁ }r (jIX-``--foo-options="--bar=C:\Program File\Bar"``jO}rà (jQ]jR]jS]jT]jV]ujJjž jD]rÄ jbX)--foo-options="--bar=C:\Program File\Bar"rÅ …rÆ }rÇ (jIUjJjÁ ubajMjŠubjbX.…rÈ }rÉ (jIX.jKNjXNjYhjJjž ubeubaubeubjy)rÊ }rË (jIX¤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.jJjŽ jKjLjMj|jO}rÌ (jQ]jR]jS]jT]jV]ujXM5jYhjD]rÍ (jbX&All of the options passed with either rÎ …rÏ }rÐ (jIX&All of the options passed with either jKNjXNjYhjJjÊ ubj­)rÑ }rÒ (jIX:option:`--prog-options`rÓ jJjÊ jKjLjMj±jO}rÔ (UreftypeXoptionj³ˆj´X--prog-optionsU refdomainXstdrÕ jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM5jD]rÖ j‚)r× }rØ (jIjÓ jO}rÙ (jQ]jR]rÚ (j¾jÕ X std-optionrÛ ejS]jT]jV]ujJjÑ jD]rÜ jbX--prog-optionsrÝ …rÞ }rß (jIUjJj× ubajMjŠubaubjbX or rà …rá }râ (jIX or jKNjXNjYhjJjÊ ubj­)rã }rä (jIX:option:`--prog-option`rå jJjÊ jKjLjMj±jO}ræ (UreftypeXoptionj³ˆj´X --prog-optionU refdomainXstdrç jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM5jD]rè j‚)ré }rê (jIjå jO}rë (jQ]jR]rì (j¾jç X std-optionrí ejS]jT]jV]ujJjã jD]rî jbX --prog-optionrï …rð }rñ (jIUjJjé ubajMjŠubaubjbXK are passed in the order they were specified on the configure command line.rò …ró }rô (jIXK are passed in the order they were specified on the configure command line.jKNjXNjYhjJjÊ ubeubeubjF)rõ }rö (jIUjJjdjKjLjMjNjO}r÷ (jQ]jR]jS]jT]rø jajV]rù h]aujXM:jYhjD]rú (j[)rû }rü (jIXInstallation pathsrý jJjõ jKjLjMj_jO}rþ (jQ]jR]jS]jT]jV]ujXM:jYhjD]rÿ jbXInstallation pathsr …r }r (jIjý jKNjXNjYhjJjû ubaubjy)r }r (jIXLThe following options govern the location of installed files from a package:r jJjõ jKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXM<jYhjD]r jbXLThe following options govern the location of installed files from a package:r …r }r (jIj jKNjXNjYhjJj ubaubj’)r }r (jIUjJjõ jKjLjMj•jO}r (jT]jS]jQ]jR]jV]Uentries]r (j˜X1setup-configure command line option; --prefix=dirj5UNtr aujXNjYhjD]ubjš)r }r (jIUjJjõ jKjLjMjjO}r (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr j£j ujXNjYhjD]r (j¥)r }r (jIX --prefix=dirjJj jKjLjMj¨jO}r (jª]r X--prefixr ajT]r j5ajS]jQ]jR]jV]r h•aj°‰ujXMIjYhjD]r (j²)r }r (jIj jJj jKjLjMjµjO}r (j½j¾jT]jS]jQ]jR]jV]ujXMIjYhjD]r jbX--prefixr! …r" }r# (jIUjKNjXNjYhjJj ubaubj»)r$ }r% (jIX=dirjJj jKjLjMj¾jO}r& (j½j¾jT]jS]jQ]jR]jV]ujXMIjYhjD]r' jbX=dirr( …r) }r* (jIUjKNjXNjYhjJj$ ubaubeubjÖ)r+ }r, (jIUjJj jKjLjMjÙjO}r- (jQ]jR]jS]jT]jV]ujXMIjYhjD]r. (jy)r/ }r0 (jIXú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.jJj+ jKjLjMj|jO}r1 (jQ]jR]jS]jT]jV]ujXMAjYhjD]r2 (jbXMThe root of the installation. For example for a global install you might use r3 …r4 }r5 (jIXMThe root of the installation. For example for a global install you might use jKNjXNjYhjJj/ ubj‚)r6 }r7 (jIX``/usr/local``jO}r8 (jQ]jR]jS]jT]jV]ujJj/ jD]r9 jbX /usr/localr: …r; }r< (jIUjJj6 ubajMjŠubjbX on a Unix system, or r= …r> }r? (jIX on a Unix system, or jKNjXNjYhjJj/ ubj‚)r@ }rA (jIX``C:\Program Files``jO}rB (jQ]jR]jS]jT]jV]ujJj/ jD]rC jbXC:\Program FilesrD …rE }rF (jIUjJj@ ubajMjŠubjbXQ on a Windows system. The other installation paths are usually subdirectories of rG …rH }rI (jIXQ on a Windows system. The other installation paths are usually subdirectories of jKNjXNjYhjJj/ ubj½)rJ }rK (jIX*prefix*jO}rL (jQ]jR]jS]jT]jV]ujJj/ jD]rM jbXprefixrN …rO }rP (jIUjJjJ ubajMjÅubjbX, but they don’t have to be.rQ …rR }rS (jIX, but they don't have to be.jKNjXNjYhjJj/ ubeubjy)rT }rU (jIX¨In the simple build system, *dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJj+ jKjLjMj|jO}rV (jQ]jR]jS]jT]jV]ujXMFjYhjD]rW (jbXIn the simple build system, rX …rY }rZ (jIXIn the simple build system, jKNjXNjYhjJjT ubj½)r[ }r\ (jIX*dir*jO}r] (jQ]jR]jS]jT]jV]ujJjT jD]r^ jbXdirr_ …r` }ra (jIUjJj[ ubajMjÅubjbX+ may contain the following path variables: rb …rc }rd (jIX+ may contain the following path variables: jKNjXNjYhjJjT ubj‚)re }rf (jIX ``$pkgid``jO}rg (jQ]jR]jS]jT]jV]ujJjT jD]rh jbX$pkgidri …rj }rk (jIUjJje ubajMjŠubjbX, rl …rm }rn (jIX, ro jKNjXNjYhjJjT ubj‚)rp }rq (jIX``$pkg``jO}rr (jQ]jR]jS]jT]jV]ujJjT jD]rs jbX$pkgrt …ru }rv (jIUjJjp ubajMjŠubjbX, rw …rx }ry (jIX, jJjT ubj‚)rz }r{ (jIX ``$version``jO}r| (jQ]jR]jS]jT]jV]ujJjT jD]r} jbX$versionr~ …r }r€ (jIUjJjz ubajMjŠubjbX, r …r‚ }rƒ (jIX, jJjT ubj‚)r„ }r… (jIX ``$compiler``jO}r† (jQ]jR]jS]jT]jV]ujJjT jD]r‡ jbX $compilerrˆ …r‰ }rŠ (jIUjJj„ ubajMjŠubjbX, r‹ …rŒ }r (jIX, jKNjXNjYhjJjT ubj‚)rŽ }r (jIX``$os``jO}r (jQ]jR]jS]jT]jV]ujJjT jD]r‘ jbX$osr’ …r“ }r” (jIUjJjŽ ubajMjŠubjbX, r• …r– }r— (jIX, jJjT ubj‚)r˜ }r™ (jIX ``$arch``jO}rš (jQ]jR]jS]jT]jV]ujJjT jD]r› jbX$archrœ …r }rž (jIUjJj˜ ubajMjŠubjbX, rŸ …r  }r¡ (jIX, jJjT ubj‚)r¢ }r£ (jIX``$abi``jO}r¤ (jQ]jR]jS]jT]jV]ujJjT jD]r¥ jbX$abir¦ …r§ }r¨ (jIUjJj¢ ubajMjŠubjbX, r© …rª }r« (jIjo jJjT ubj‚)r¬ }r­ (jIX ``$abitag``jO}r® (jQ]jR]jS]jT]jV]ujJjT jD]r¯ jbX$abitagr° …r± }r² (jIUjJj¬ ubajMjŠubeubeubeubj’)r³ }r´ (jIUjJjõ jKjLjMj•jO}rµ (jT]jS]jQ]jR]jV]Uentries]r¶ (j˜X1setup-configure command line option; --bindir=dirhØUNtr· aujXNjYhjD]ubjš)r¸ }r¹ (jIUjJjõ jKjLjMjjO}rº (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr» j£j» ujXNjYhjD]r¼ (j¥)r½ }r¾ (jIX --bindir=dirjJj¸ jKjLjMj¨jO}r¿ (jª]rÀ X--bindirrÁ ajT]r hØajS]jQ]jR]jV]rà h1aj°‰ujXMQjYhjD]rÄ (j²)rÅ }rÆ (jIjÁ jJj½ jKjLjMjµjO}rÇ (j½j¾jT]jS]jQ]jR]jV]ujXMQjYhjD]rÈ jbX--bindirrÉ …rÊ }rË (jIUjKNjXNjYhjJjÅ ubaubj»)rÌ }rÍ (jIX=dirjJj½ jKjLjMj¾jO}rÎ (j½j¾jT]jS]jQ]jR]jV]ujXMQjYhjD]rÏ jbX=dirrÐ …rÑ }rÒ (jIUjKNjXNjYhjJjÌ ubaubeubjÖ)rÓ }rÔ (jIUjJj¸ jKjLjMjÙjO}rÕ (jQ]jR]jS]jT]jV]ujXMQjYhjD]rÖ (jy)r× }rØ (jIX:Executables that the user might invoke are installed here.rÙ jJjÓ jKjLjMj|jO}rÚ (jQ]jR]jS]jT]jV]ujXMLjYhjD]rÛ jbX:Executables that the user might invoke are installed here.rÜ …rÝ }rÞ (jIjÙ jKNjXNjYhjJj× ubaubjy)rß }rà (jIXµIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjÓ jKjLjMj|jO}rá (jQ]jR]jS]jT]jV]ujXMNjYhjD]râ (jbXIn the simple build system, rã …rä }rå (jIXIn the simple build system, jKNjXNjYhjJjß ubj½)ræ }rç (jIX*dir*jO}rè (jQ]jR]jS]jT]jV]ujJjß jD]ré jbXdirrê …rë }rì (jIUjJjæ ubajMjÅubjbX+ may contain the following path variables: rí …rî }rï (jIX+ may contain the following path variables: jKNjXNjYhjJjß ubj‚)rð }rñ (jIX ``$prefix``jO}rò (jQ]jR]jS]jT]jV]ujJjß jD]ró jbX$prefixrô …rõ }rö (jIUjJjð ubajMjŠubjbX, r÷ …rø }rù (jIX, rú jKNjXNjYhjJjß ubj‚)rû }rü (jIX ``$pkgid``jO}rý (jQ]jR]jS]jT]jV]ujJjß jD]rþ jbX$pkgidrÿ …r}r(jIUjJjû ubajMjŠubjbX, r…r}r(jIX, jJjß ubj‚)r}r(jIX``$pkg``jO}r(jQ]jR]jS]jT]jV]ujJjß jD]rjbX$pkgr …r }r (jIUjJjubajMjŠubjbX, r …r }r(jIX, jJjß ubj‚)r}r(jIX ``$version``jO}r(jQ]jR]jS]jT]jV]ujJjß jD]rjbX$versionr…r}r(jIUjJjubajMjŠubjbX, r…r}r(jIX, jKNjXNjYhjJjß ubj‚)r}r(jIX ``$compiler``jO}r(jQ]jR]jS]jT]jV]ujJjß jD]rjbX $compilerr…r}r(jIUjJjubajMjŠubjbX, r …r!}r"(jIX, jJjß ubj‚)r#}r$(jIX``$os``jO}r%(jQ]jR]jS]jT]jV]ujJjß jD]r&jbX$osr'…r(}r)(jIUjJj#ubajMjŠubjbX, r*…r+}r,(jIX, jJjß ubj‚)r-}r.(jIX ``$arch``jO}r/(jQ]jR]jS]jT]jV]ujJjß jD]r0jbX$archr1…r2}r3(jIUjJj-ubajMjŠubjbX, r4…r5}r6(jIX, jJjß ubj‚)r7}r8(jIX``$abi``jO}r9(jQ]jR]jS]jT]jV]ujJjß jD]r:jbX$abir;…r<}r=(jIUjJj7ubajMjŠubjbX, r>…r?}r@(jIjú jJjß ubj‚)rA}rB(jIX ``$abitag``jO}rC(jQ]jR]jS]jT]jV]ujJjß jD]rDjbX$abitagrE…rF}rG(jIUjJjAubajMjŠubeubeubeubj’)rH}rI(jIUjJjõ jKjLjMj•jO}rJ(jT]jS]jQ]jR]jV]Uentries]rK(j˜X1setup-configure command line option; --libdir=dirhÓUNtrLaujXNjYhjD]ubjš)rM}rN(jIUjJjõ jKjLjMjjO}rO(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrPj£jPujXNjYhjD]rQ(j¥)rR}rS(jIX --libdir=dirjJjMjKjLjMj¨jO}rT(jª]rUX--libdirrVajT]rWhÓajS]jQ]jR]jV]rXh,aj°‰ujXMZjYhjD]rY(j²)rZ}r[(jIjVjJjRjKjLjMjµjO}r\(j½j¾jT]jS]jQ]jR]jV]ujXMZjYhjD]r]jbX--libdirr^…r_}r`(jIUjKNjXNjYhjJjZubaubj»)ra}rb(jIX=dirjJjRjKjLjMj¾jO}rc(j½j¾jT]jS]jQ]jR]jV]ujXMZjYhjD]rdjbX=dirre…rf}rg(jIUjKNjXNjYhjJjaubaubeubjÖ)rh}ri(jIUjJjMjKjLjMjÙjO}rj(jQ]jR]jS]jT]jV]ujXMZjYhjD]rk(jy)rl}rm(jIX)Object-code libraries are installed here.rnjJjhjKjLjMj|jO}ro(jQ]jR]jS]jT]jV]ujXMTjYhjD]rpjbX)Object-code libraries are installed here.rq…rr}rs(jIjnjKNjXNjYhjJjlubaubjy)rt}ru(jIXÂIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjhjKjLjMj|jO}rv(jQ]jR]jS]jT]jV]ujXMVjYhjD]rw(jbXIn the simple build system, rx…ry}rz(jIXIn the simple build system, jKNjXNjYhjJjtubj½)r{}r|(jIX*dir*jO}r}(jQ]jR]jS]jT]jV]ujJjtjD]r~jbXdirr…r€}r(jIUjJj{ubajMjÅubjbX+ may contain the following path variables: r‚…rƒ}r„(jIX+ may contain the following path variables: jKNjXNjYhjJjtubj‚)r…}r†(jIX ``$prefix``jO}r‡(jQ]jR]jS]jT]jV]ujJjtjD]rˆjbX$prefixr‰…rŠ}r‹(jIUjJj…ubajMjŠubjbX, rŒ…r}rŽ(jIX, rjKNjXNjYhjJjtubj‚)r}r‘(jIX ``$bindir``jO}r’(jQ]jR]jS]jT]jV]ujJjtjD]r“jbX$bindirr”…r•}r–(jIUjJjubajMjŠubjbX, r—…r˜}r™(jIX, jJjtubj‚)rš}r›(jIX ``$pkgid``jO}rœ(jQ]jR]jS]jT]jV]ujJjtjD]rjbX$pkgidrž…rŸ}r (jIUjJjšubajMjŠubjbX, r¡…r¢}r£(jIX, jJjtubj‚)r¤}r¥(jIX``$pkg``jO}r¦(jQ]jR]jS]jT]jV]ujJjtjD]r§jbX$pkgr¨…r©}rª(jIUjJj¤ubajMjŠubjbX, r«…r¬}r­(jIX, r®jKNjXNjYhjJjtubj‚)r¯}r°(jIX ``$version``jO}r±(jQ]jR]jS]jT]jV]ujJjtjD]r²jbX$versionr³…r´}rµ(jIUjJj¯ubajMjŠubjbX, r¶…r·}r¸(jIX, jJjtubj‚)r¹}rº(jIX ``$compiler``jO}r»(jQ]jR]jS]jT]jV]ujJjtjD]r¼jbX $compilerr½…r¾}r¿(jIUjJj¹ubajMjŠubjbX, rÀ…rÁ}rÂ(jIX, jJjtubj‚)rÃ}rÄ(jIX``$os``jO}rÅ(jQ]jR]jS]jT]jV]ujJjtjD]rÆjbX$osrÇ…rÈ}rÉ(jIUjJjÃubajMjŠubjbX, rÊ…rË}rÌ(jIX, jJjtubj‚)rÍ}rÎ(jIX ``$arch``jO}rÏ(jQ]jR]jS]jT]jV]ujJjtjD]rÐjbX$archrÑ…rÒ}rÓ(jIUjJjÍubajMjŠubjbX, rÔ…rÕ}rÖ(jIjjJjtubj‚)r×}rØ(jIX``$abi``jO}rÙ(jQ]jR]jS]jT]jV]ujJjtjD]rÚjbX$abirÛ…rÜ}rÝ(jIUjJj×ubajMjŠubjbX, rÞ…rß}rà(jIj®jJjtubj‚)rá}râ(jIX ``$abitag``jO}rã(jQ]jR]jS]jT]jV]ujJjtjD]räjbX$abitagrå…ræ}rç(jIUjJjáubajMjŠubeubeubeubj’)rè}ré(jIUjJjõ jKjLjMj•jO}rê(jT]jS]jQ]jR]jV]Uentries]rë(j˜X4setup-configure command line option; --dynlibdir=dirhÙUNtrìaujXNjYhjD]ubjš)rí}rî(jIUjJjõ jKjLjMjjO}rï(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrðj£jðujXNjYhjD]rñ(j¥)rò}ró(jIX--dynlibdir=dirjJjíjKjLjMj¨jO}rô(jª]rõX --dynlibdirröajT]r÷hÙajS]jQ]jR]jV]røh2aj°‰ujXMfjYhjD]rù(j²)rú}rû(jIjöjJjòjKjLjMjµjO}rü(j½j¾jT]jS]jQ]jR]jV]ujXMfjYhjD]rýjbX --dynlibdirrþ…rÿ}r(jIUjKNjXNjYhjJjúubaubj»)r}r(jIX=dirjJjòjKjLjMj¾jO}r(j½j¾jT]jS]jQ]jR]jV]ujXMfjYhjD]rjbX=dirr…r}r(jIUjKNjXNjYhjJjubaubeubjÖ)r}r (jIUjJjíjKjLjMjÙjO}r (jQ]jR]jS]jT]jV]ujXMfjYhjD]r (jy)r }r (jIX%Dynamic libraries are installed here.rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM]jYhjD]rjbX%Dynamic libraries are installed here.r…r}r(jIjjKNjXNjYhjJj ubaubjy)r}r(jIX^By default, this is set to `$libdir/$abi`, which is usually not equal to `$libdir/$libsubdir`.jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM_jYhjD]r(jbXBy default, this is set to r…r}r(jIXBy default, this is set to jKNjXNjYhjJjubcdocutils.nodes title_reference r)r}r(jIX`$libdir/$abi`jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbX $libdir/$abir …r!}r"(jIUjJjubajMUtitle_referencer#ubjbX , which is usually not equal to r$…r%}r&(jIX , which is usually not equal to jKNjXNjYhjJjubj)r'}r((jIX`$libdir/$libsubdir`jO}r)(jQ]jR]jS]jT]jV]ujJjjD]r*jbX$libdir/$libsubdirr+…r,}r-(jIUjJj'ubajMj#ubjbX.…r.}r/(jIX.jKNjXNjYhjJjubeubjy)r0}r1(jIXÏIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjjKjLjMj|jO}r2(jQ]jR]jS]jT]jV]ujXMbjYhjD]r3(jbXIn the simple build system, r4…r5}r6(jIXIn the simple build system, jKNjXNjYhjJj0ubj½)r7}r8(jIX*dir*jO}r9(jQ]jR]jS]jT]jV]ujJj0jD]r:jbXdirr;…r<}r=(jIUjJj7ubajMjÅubjbX+ may contain the following path variables: r>…r?}r@(jIX+ may contain the following path variables: jKNjXNjYhjJj0ubj‚)rA}rB(jIX ``$prefix``jO}rC(jQ]jR]jS]jT]jV]ujJj0jD]rDjbX$prefixrE…rF}rG(jIUjJjAubajMjŠubjbX, rH…rI}rJ(jIX, rKjKNjXNjYhjJj0ubj‚)rL}rM(jIX ``$bindir``jO}rN(jQ]jR]jS]jT]jV]ujJj0jD]rOjbX$bindirrP…rQ}rR(jIUjJjLubajMjŠubjbX, rS…rT}rU(jIX, jJj0ubj‚)rV}rW(jIX ``$libdir``jO}rX(jQ]jR]jS]jT]jV]ujJj0jD]rYjbX$libdirrZ…r[}r\(jIUjJjVubajMjŠubjbX, r]…r^}r_(jIX, jJj0ubj‚)r`}ra(jIX ``$pkgid``jO}rb(jQ]jR]jS]jT]jV]ujJj0jD]rcjbX$pkgidrd…re}rf(jIUjJj`ubajMjŠubjbX, rg…rh}ri(jIX, jJj0ubj‚)rj}rk(jIX``$pkg``jO}rl(jQ]jR]jS]jT]jV]ujJj0jD]rmjbX$pkgrn…ro}rp(jIUjJjjubajMjŠubjbX, rq…rr}rs(jIX, rtjKNjXNjYhjJj0ubj‚)ru}rv(jIX ``$version``jO}rw(jQ]jR]jS]jT]jV]ujJj0jD]rxjbX$versionry…rz}r{(jIUjJjuubajMjŠubjbX, r|…r}}r~(jIX, jJj0ubj‚)r}r€(jIX ``$compiler``jO}r(jQ]jR]jS]jT]jV]ujJj0jD]r‚jbX $compilerrƒ…r„}r…(jIUjJjubajMjŠubjbX, r†…r‡}rˆ(jIX, jJj0ubj‚)r‰}rŠ(jIX``$os``jO}r‹(jQ]jR]jS]jT]jV]ujJj0jD]rŒjbX$osr…rŽ}r(jIUjJj‰ubajMjŠubjbX, r…r‘}r’(jIX, jJj0ubj‚)r“}r”(jIX ``$arch``jO}r•(jQ]jR]jS]jT]jV]ujJj0jD]r–jbX$archr—…r˜}r™(jIUjJj“ubajMjŠubjbX, rš…r›}rœ(jIjKjJj0ubj‚)r}rž(jIX``$abi``jO}rŸ(jQ]jR]jS]jT]jV]ujJj0jD]r jbX$abir¡…r¢}r£(jIUjJjubajMjŠubjbX, r¤…r¥}r¦(jIjtjJj0ubj‚)r§}r¨(jIX ``$abitag``jO}r©(jQ]jR]jS]jT]jV]ujJj0jD]rªjbX$abitagr«…r¬}r­(jIUjJj§ubajMjŠubeubeubeubj’)r®}r¯(jIUjJjõ jKjLjMj•jO}r°(jT]jS]jQ]jR]jV]Uentries]r±(j˜X5setup-configure command line option; --libexecdir=dirh¶UNtr²aujXNjYhjD]ubjš)r³}r´(jIUjJjõ jKjLjMjjO}rµ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr¶j£j¶ujXNjYhjD]r·(j¥)r¸}r¹(jIX--libexecdir=dirjJj³jKjLjMj¨jO}rº(jª]r»X --libexecdirr¼ajT]r½h¶ajS]jQ]jR]jV]r¾haj°‰ujXMpjYhjD]r¿(j²)rÀ}rÁ(jIj¼jJj¸jKjLjMjµjO}rÂ(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]rÃjbX --libexecdirrÄ…rÅ}rÆ(jIUjKNjXNjYhjJjÀubaubj»)rÇ}rÈ(jIX=dirjJj¸jKjLjMj¾jO}rÉ(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]rÊjbX=dirrË…rÌ}rÍ(jIUjKNjXNjYhjJjÇubaubeubjÖ)rÎ}rÏ(jIUjJj³jKjLjMjÙjO}rÐ(jQ]jR]jS]jT]jV]ujXMpjYhjD]rÑ(jy)rÒ}rÓ(jIXXExecutables that are not expected to be invoked directly by the user are installed here.rÔjJjÎjKjLjMj|jO}rÕ(jQ]jR]jS]jT]jV]ujXMijYhjD]rÖjbXXExecutables that are not expected to be invoked directly by the user are installed here.r×…rØ}rÙ(jIjÔjKNjXNjYhjJjÒubaubjy)rÚ}rÛ(jIXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjÎjKjLjMj|jO}rÜ(jQ]jR]jS]jT]jV]ujXMljYhjD]rÝ(jbXIn the simple build system, rÞ…rß}rà(jIXIn the simple build system, jKNjXNjYhjJjÚubj½)rá}râ(jIX*dir*jO}rã(jQ]jR]jS]jT]jV]ujJjÚjD]räjbXdirrå…ræ}rç(jIUjJjáubajMjÅubjbX+ may contain the following path variables: rè…ré}rê(jIX+ may contain the following path variables: jKNjXNjYhjJjÚubj‚)rë}rì(jIX ``$prefix``jO}rí(jQ]jR]jS]jT]jV]ujJjÚjD]rîjbX$prefixrï…rð}rñ(jIUjJjëubajMjŠubjbX, rò…ró}rô(jIX, rõjKNjXNjYhjJjÚubj‚)rö}r÷(jIX ``$bindir``jO}rø(jQ]jR]jS]jT]jV]ujJjÚjD]rùjbX$bindirrú…rû}rü(jIUjJjöubajMjŠubjbX, rý…rþ}rÿ(jIX, jJjÚubj‚)r}r(jIX ``$libdir``jO}r(jQ]jR]jS]jT]jV]ujJjÚjD]rjbX$libdirr…r}r(jIUjJjubajMjŠubjbX, r…r}r (jIX, jJjÚubj‚)r }r (jIX``$libsubdir``jO}r (jQ]jR]jS]jT]jV]ujJjÚjD]r jbX $libsubdirr…r}r(jIUjJj ubajMjŠubjbX, r…r}r(jIX, rjKNjXNjYhjJjÚubj‚)r}r(jIX ``$pkgid``jO}r(jQ]jR]jS]jT]jV]ujJjÚjD]rjbX$pkgidr…r}r(jIUjJjubajMjŠubjbX, r…r}r(jIX, jJjÚubj‚)r}r (jIX``$pkg``jO}r!(jQ]jR]jS]jT]jV]ujJjÚjD]r"jbX$pkgr#…r$}r%(jIUjJjubajMjŠubjbX, r&…r'}r((jIX, jJjÚubj‚)r)}r*(jIX ``$version``jO}r+(jQ]jR]jS]jT]jV]ujJjÚjD]r,jbX$versionr-…r.}r/(jIUjJj)ubajMjŠubjbX, r0…r1}r2(jIX, jJjÚubj‚)r3}r4(jIX ``$compiler``jO}r5(jQ]jR]jS]jT]jV]ujJjÚjD]r6jbX $compilerr7…r8}r9(jIUjJj3ubajMjŠubjbX, r:…r;}r<(jIX, jJjÚubj‚)r=}r>(jIX``$os``jO}r?(jQ]jR]jS]jT]jV]ujJjÚjD]r@jbX$osrA…rB}rC(jIUjJj=ubajMjŠubjbX, rD…rE}rF(jIjjJjÚubj‚)rG}rH(jIX ``$arch``jO}rI(jQ]jR]jS]jT]jV]ujJjÚjD]rJjbX$archrK…rL}rM(jIUjJjGubajMjŠubjbX, rN…rO}rP(jIX, jJjÚubj‚)rQ}rR(jIX``$abi``jO}rS(jQ]jR]jS]jT]jV]ujJjÚjD]rTjbX$abirU…rV}rW(jIUjJjQubajMjŠubjbX, rX…rY}rZ(jIjõjJjÚubj‚)r[}r\(jIX ``$abitag``jO}r](jQ]jR]jS]jT]jV]ujJjÚjD]r^jbX$abitagr_…r`}ra(jIUjJj[ubajMjŠubeubeubeubj’)rb}rc(jIUjJjõ jKjLjMj•jO}rd(jT]jS]jQ]jR]jV]Uentries]re(j˜X2setup-configure command line option; --datadir=dirhÛUNtrfaujXNjYhjD]ubjš)rg}rh(jIUjJjõ jKjLjMjjO}ri(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrjj£jjujXNjYhjD]rk(j¥)rl}rm(jIX --datadir=dirjJjgjKjLjMj¨jO}rn(jª]roX --datadirrpajT]rqhÛajS]jQ]jR]jV]rrh4aj°‰ujXMyjYhjD]rs(j²)rt}ru(jIjpjJjljKjLjMjµjO}rv(j½j¾jT]jS]jQ]jR]jV]ujXMyjYhjD]rwjbX --datadirrx…ry}rz(jIUjKNjXNjYhjJjtubaubj»)r{}r|(jIX=dirjJjljKjLjMj¾jO}r}(j½j¾jT]jS]jQ]jR]jV]ujXMyjYhjD]r~jbX=dirr…r€}r(jIUjKNjXNjYhjJj{ubaubeubjÖ)r‚}rƒ(jIUjJjgjKjLjMjÙjO}r„(jQ]jR]jS]jT]jV]ujXMyjYhjD]r…(jy)r†}r‡(jIX7Architecture-independent data files are installed here.rˆjJj‚jKjLjMj|jO}r‰(jQ]jR]jS]jT]jV]ujXMsjYhjD]rŠjbX7Architecture-independent data files are installed here.r‹…rŒ}r(jIjˆjKNjXNjYhjJj†ubaubjy)rŽ}r(jIXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJj‚jKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMujYhjD]r‘(jbXIn the simple build system, r’…r“}r”(jIXIn the simple build system, jKNjXNjYhjJjŽubj½)r•}r–(jIX*dir*jO}r—(jQ]jR]jS]jT]jV]ujJjŽjD]r˜jbXdirr™…rš}r›(jIUjJj•ubajMjÅubjbX+ may contain the following path variables: rœ…r}rž(jIX+ may contain the following path variables: jKNjXNjYhjJjŽubj‚)rŸ}r (jIX ``$prefix``jO}r¡(jQ]jR]jS]jT]jV]ujJjŽjD]r¢jbX$prefixr£…r¤}r¥(jIUjJjŸubajMjŠubjbX, r¦…r§}r¨(jIX, r©jKNjXNjYhjJjŽubj‚)rª}r«(jIX ``$bindir``jO}r¬(jQ]jR]jS]jT]jV]ujJjŽjD]r­jbX$bindirr®…r¯}r°(jIUjJjªubajMjŠubjbX, r±…r²}r³(jIX, jJjŽubj‚)r´}rµ(jIX ``$libdir``jO}r¶(jQ]jR]jS]jT]jV]ujJjŽjD]r·jbX$libdirr¸…r¹}rº(jIUjJj´ubajMjŠubjbX, r»…r¼}r½(jIX, jJjŽubj‚)r¾}r¿(jIX``$libsubdir``jO}rÀ(jQ]jR]jS]jT]jV]ujJjŽjD]rÁjbX $libsubdirrÂ…rÃ}rÄ(jIUjJj¾ubajMjŠubjbX, rÅ…rÆ}rÇ(jIX, rÈjKNjXNjYhjJjŽubj‚)rÉ}rÊ(jIX ``$pkgid``jO}rË(jQ]jR]jS]jT]jV]ujJjŽjD]rÌjbX$pkgidrÍ…rÎ}rÏ(jIUjJjÉubajMjŠubjbX, rÐ…rÑ}rÒ(jIX, jJjŽubj‚)rÓ}rÔ(jIX``$pkg``jO}rÕ(jQ]jR]jS]jT]jV]ujJjŽjD]rÖjbX$pkgr×…rØ}rÙ(jIUjJjÓubajMjŠubjbX, rÚ…rÛ}rÜ(jIX, jJjŽubj‚)rÝ}rÞ(jIX ``$version``jO}rß(jQ]jR]jS]jT]jV]ujJjŽjD]ràjbX$versionrá…râ}rã(jIUjJjÝubajMjŠubjbX, rä…rå}ræ(jIX, jJjŽubj‚)rç}rè(jIX ``$compiler``jO}ré(jQ]jR]jS]jT]jV]ujJjŽjD]rêjbX $compilerrë…rì}rí(jIUjJjçubajMjŠubjbX, rî…rï}rð(jIX, jJjŽubj‚)rñ}rò(jIX``$os``jO}ró(jQ]jR]jS]jT]jV]ujJjŽjD]rôjbX$osrõ…rö}r÷(jIUjJjñubajMjŠubjbX, rø…rù}rú(jIjÈjJjŽubj‚)rû}rü(jIX ``$arch``jO}rý(jQ]jR]jS]jT]jV]ujJjŽjD]rþjbX$archrÿ…r}r(jIUjJjûubajMjŠubjbX, r…r}r(jIX, jJjŽubj‚)r}r(jIX``$abi``jO}r(jQ]jR]jS]jT]jV]ujJjŽjD]rjbX$abir …r }r (jIUjJjubajMjŠubjbX, r …r }r(jIj©jJjŽubj‚)r}r(jIX ``$abitag``jO}r(jQ]jR]jS]jT]jV]ujJjŽjD]rjbX$abitagr…r}r(jIUjJjubajMjŠubeubeubeubj’)r}r(jIUjJjõ jKjLjMj•jO}r(jT]jS]jQ]jR]jV]Uentries]r(j˜X5setup-configure command line option; --sysconfdir=dirjUNtraujXNjYhjD]ubjš)r}r(jIUjJjõ jKjLjMjjO}r(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrj£jujXNjYhjD]r(j¥)r }r!(jIX--sysconfdir=dirjJjjKjLjMj¨jO}r"(jª]r#X --sysconfdirr$ajT]r%jajS]jQ]jR]jV]r&hzaj°‰ujXM‚jYhjD]r'(j²)r(}r)(jIj$jJj jKjLjMjµjO}r*(j½j¾jT]jS]jQ]jR]jV]ujXM‚jYhjD]r+jbX --sysconfdirr,…r-}r.(jIUjKNjXNjYhjJj(ubaubj»)r/}r0(jIX=dirjJj jKjLjMj¾jO}r1(j½j¾jT]jS]jQ]jR]jV]ujXM‚jYhjD]r2jbX=dirr3…r4}r5(jIUjKNjXNjYhjJj/ubaubeubjÖ)r6}r7(jIUjJjjKjLjMjÙjO}r8(jQ]jR]jS]jT]jV]ujXM‚jYhjD]r9(jy)r:}r;(jIX3Installation directory for the configuration files.r<jJj6jKjLjMj|jO}r=(jQ]jR]jS]jT]jV]ujXM|jYhjD]r>jbX3Installation directory for the configuration files.r?…r@}rA(jIj<jKNjXNjYhjJj:ubaubjy)rB}rC(jIXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJj6jKjLjMj|jO}rD(jQ]jR]jS]jT]jV]ujXM~jYhjD]rE(jbXIn the simple build system, rF…rG}rH(jIXIn the simple build system, jKNjXNjYhjJjBubj½)rI}rJ(jIX*dir*jO}rK(jQ]jR]jS]jT]jV]ujJjBjD]rLjbXdirrM…rN}rO(jIUjJjIubajMjÅubjbX+ may contain the following path variables: rP…rQ}rR(jIX+ may contain the following path variables: jKNjXNjYhjJjBubj‚)rS}rT(jIX ``$prefix``jO}rU(jQ]jR]jS]jT]jV]ujJjBjD]rVjbX$prefixrW…rX}rY(jIUjJjSubajMjŠubjbX, rZ…r[}r\(jIX, r]jKNjXNjYhjJjBubj‚)r^}r_(jIX ``$bindir``jO}r`(jQ]jR]jS]jT]jV]ujJjBjD]rajbX$bindirrb…rc}rd(jIUjJj^ubajMjŠubjbX, re…rf}rg(jIX, jJjBubj‚)rh}ri(jIX ``$libdir``jO}rj(jQ]jR]jS]jT]jV]ujJjBjD]rkjbX$libdirrl…rm}rn(jIUjJjhubajMjŠubjbX, ro…rp}rq(jIX, jJjBubj‚)rr}rs(jIX``$libsubdir``jO}rt(jQ]jR]jS]jT]jV]ujJjBjD]rujbX $libsubdirrv…rw}rx(jIUjJjrubajMjŠubjbX, ry…rz}r{(jIX, r|jKNjXNjYhjJjBubj‚)r}}r~(jIX ``$pkgid``jO}r(jQ]jR]jS]jT]jV]ujJjBjD]r€jbX$pkgidr…r‚}rƒ(jIUjJj}ubajMjŠubjbX, r„…r…}r†(jIX, jJjBubj‚)r‡}rˆ(jIX``$pkg``jO}r‰(jQ]jR]jS]jT]jV]ujJjBjD]rŠjbX$pkgr‹…rŒ}r(jIUjJj‡ubajMjŠubjbX, rŽ…r}r(jIX, jJjBubj‚)r‘}r’(jIX ``$version``jO}r“(jQ]jR]jS]jT]jV]ujJjBjD]r”jbX$versionr•…r–}r—(jIUjJj‘ubajMjŠubjbX, r˜…r™}rš(jIX, jJjBubj‚)r›}rœ(jIX ``$compiler``jO}r(jQ]jR]jS]jT]jV]ujJjBjD]ržjbX $compilerrŸ…r }r¡(jIUjJj›ubajMjŠubjbX, r¢…r£}r¤(jIX, jJjBubj‚)r¥}r¦(jIX``$os``jO}r§(jQ]jR]jS]jT]jV]ujJjBjD]r¨jbX$osr©…rª}r«(jIUjJj¥ubajMjŠubjbX, r¬…r­}r®(jIj|jJjBubj‚)r¯}r°(jIX ``$arch``jO}r±(jQ]jR]jS]jT]jV]ujJjBjD]r²jbX$archr³…r´}rµ(jIUjJj¯ubajMjŠubjbX, r¶…r·}r¸(jIX, jJjBubj‚)r¹}rº(jIX``$abi``jO}r»(jQ]jR]jS]jT]jV]ujJjBjD]r¼jbX$abir½…r¾}r¿(jIUjJj¹ubajMjŠubjbX, rÀ…rÁ}rÂ(jIj]jJjBubj‚)rÃ}rÄ(jIX ``$abitag``jO}rÅ(jQ]jR]jS]jT]jV]ujJjBjD]rÆjbX$abitagrÇ…rÈ}rÉ(jIUjJjÃubajMjŠubeubeubeubjy)rÊ}rË(jIXUIn addition the simple build system supports the following installation path options:rÌjJjõ jKjLjMj|jO}rÍ(jQ]jR]jS]jT]jV]ujXMƒjYhjD]rÎjbXUIn addition the simple build system supports the following installation path options:rÏ…rÐ}rÑ(jIjÌjKNjXNjYhjJjÊubaubj’)rÒ}rÓ(jIUjJjõ jKjLjMj•jO}rÔ(jT]jS]jQ]jR]jV]Uentries]rÕ(j˜X4setup-configure command line option; --libsubdir=dirjUNtrÖaujXNjYhjD]ubjš)r×}rØ(jIUjJjõ jKjLjMjjO}rÙ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÚj£jÚujXNjYhjD]rÛ(j¥)rÜ}rÝ(jIX--libsubdir=dirjJj×jKjLjMj¨jO}rÞ(jª]rßX --libsubdirràajT]rájajS]jQ]jR]jV]râh|aj°‰ujXM“jYhjD]rã(j²)rä}rå(jIjàjJjÜjKjLjMjµjO}ræ(j½j¾jT]jS]jQ]jR]jV]ujXM“jYhjD]rçjbX --libsubdirrè…ré}rê(jIUjKNjXNjYhjJjäubaubj»)rë}rì(jIX=dirjJjÜjKjLjMj¾jO}rí(j½j¾jT]jS]jQ]jR]jV]ujXM“jYhjD]rîjbX=dirrï…rð}rñ(jIUjKNjXNjYhjJjëubaubeubjÖ)rò}ró(jIUjJj×jKjLjMjÙjO}rô(jQ]jR]jS]jT]jV]ujXM“jYhjD]rõ(jy)rö}r÷(jIX˜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/``.jJjòjKjLjMj|jO}rø(jQ]jR]jS]jT]jV]ujXMˆjYhjD]rù(jbXA subdirectory of rú…rû}rü(jIXA subdirectory of jKNjXNjYhjJjöubj½)rý}rþ(jIX*libdir*jO}rÿ(jQ]jR]jS]jT]jV]ujJjöjD]rjbXlibdirr…r}r(jIUjJjýubajMjÅubjbXi in which libraries are actually installed. For example, in the simple build system on Unix, the default r…r}r(jIXi in which libraries are actually installed. For example, in the simple build system on Unix, the default jKNjXNjYhjJjöubj½)r}r(jIX*libdir*jO}r (jQ]jR]jS]jT]jV]ujJjöjD]r jbXlibdirr …r }r (jIUjJjubajMjÅubjbX is r…r}r(jIX is jKNjXNjYhjJjöubj‚)r}r(jIX``/usr/local/lib``jO}r(jQ]jR]jS]jT]jV]ujJjöjD]rjbX/usr/local/libr…r}r(jIUjJjubajMjŠubjbX, and r…r}r(jIX, and jKNjXNjYhjJjöubj½)r}r(jIX *libsubdir*jO}r(jQ]jR]jS]jT]jV]ujJjöjD]rjbX libsubdirr…r }r!(jIUjJjubajMjÅubjbX8 contains the compiler ABI and package identifier, e.g. r"…r#}r$(jIX8 contains the compiler ABI and package identifier, e.g. jKNjXNjYhjJjöubj‚)r%}r&(jIX<``x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A``jO}r'(jQ]jR]jS]jT]jV]ujJjöjD]r(jbX8x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7Ar)…r*}r+(jIUjJj%ubajMjŠubjbX%, so libraries would be installed in r,…r-}r.(jIX%, so libraries would be installed in jKNjXNjYhjJjöubj‚)r/}r0(jIXL``/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/``jO}r1(jQ]jR]jS]jT]jV]ujJjöjD]r2jbXH/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/r3…r4}r5(jIUjJj/ubajMjŠubjbX.…r6}r7(jIX.jKNjXNjYhjJjöubeubjy)r8}r9(jIXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjòjKjLjMj|jO}r:(jQ]jR]jS]jT]jV]ujXMjYhjD]r;(j½)r<}r=(jIX*dir*jO}r>(jQ]jR]jS]jT]jV]ujJj8jD]r?jbXdirr@…rA}rB(jIUjJj<ubajMjÅubjbX+ may contain the following path variables: rC…rD}rE(jIX+ may contain the following path variables: jKNjXNjYhjJj8ubj‚)rF}rG(jIX ``$pkgid``jO}rH(jQ]jR]jS]jT]jV]ujJj8jD]rIjbX$pkgidrJ…rK}rL(jIUjJjFubajMjŠubjbX, rM…rN}rO(jIX, rPjKNjXNjYhjJj8ubj‚)rQ}rR(jIX``$pkg``jO}rS(jQ]jR]jS]jT]jV]ujJj8jD]rTjbX$pkgrU…rV}rW(jIUjJjQubajMjŠubjbX, rX…rY}rZ(jIX, r[jKNjXNjYhjJj8ubj‚)r\}r](jIX ``$version``jO}r^(jQ]jR]jS]jT]jV]ujJj8jD]r_jbX$versionr`…ra}rb(jIUjJj\ubajMjŠubjbX, rc…rd}re(jIX, jJj8ubj‚)rf}rg(jIX ``$compiler``jO}rh(jQ]jR]jS]jT]jV]ujJj8jD]rijbX $compilerrj…rk}rl(jIUjJjfubajMjŠubjbX, rm…rn}ro(jIX, jJj8ubj‚)rp}rq(jIX``$os``jO}rr(jQ]jR]jS]jT]jV]ujJj8jD]rsjbX$osrt…ru}rv(jIUjJjpubajMjŠubjbX, rw…rx}ry(jIX, jJj8ubj‚)rz}r{(jIX ``$arch``jO}r|(jQ]jR]jS]jT]jV]ujJj8jD]r}jbX$archr~…r}r€(jIUjJjzubajMjŠubjbX, r…r‚}rƒ(jIj[jJj8ubj‚)r„}r…(jIX``$abi``jO}r†(jQ]jR]jS]jT]jV]ujJj8jD]r‡jbX$abirˆ…r‰}rŠ(jIUjJj„ubajMjŠubjbX, r‹…rŒ}r(jIjPjJj8ubj‚)rŽ}r(jIX ``$abitag``jO}r(jQ]jR]jS]jT]jV]ujJj8jD]r‘jbX$abitagr’…r“}r”(jIUjJjŽubajMjŠubeubeubeubj’)r•}r–(jIUjJjõ jKjLjMj•jO}r—(jT]jS]jQ]jR]jV]Uentries]r˜(j˜X8setup-configure command line option; --libexecsubdir=dirhÕUNtr™aujXNjYhjD]ubjš)rš}r›(jIUjJjõ jKjLjMjjO}rœ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrj£jujXNjYhjD]rž(j¥)rŸ}r (jIX--libexecsubdir=dirjJjšjKjLjMj¨jO}r¡(jª]r¢X--libexecsubdirr£ajT]r¤hÕajS]jQ]jR]jV]r¥h.aj°‰ujXMŸjYhjD]r¦(j²)r§}r¨(jIj£jJjŸjKjLjMjµjO}r©(j½j¾jT]jS]jQ]jR]jV]ujXMŸjYhjD]rªjbX--libexecsubdirr«…r¬}r­(jIUjKNjXNjYhjJj§ubaubj»)r®}r¯(jIX=dirjJjŸjKjLjMj¾jO}r°(j½j¾jT]jS]jQ]jR]jV]ujXMŸjYhjD]r±jbX=dirr²…r³}r´(jIUjKNjXNjYhjJj®ubaubeubjÖ)rµ}r¶(jIUjJjšjKjLjMjÙjO}r·(jQ]jR]jS]jT]jV]ujXMŸjYhjD]r¸(jy)r¹}rº(jIXRA 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/``jJjµjKjLjMj|jO}r»(jQ]jR]jS]jT]jV]ujXM–jYhjD]r¼(jbXA subdirectory of r½…r¾}r¿(jIXA subdirectory of jKNjXNjYhjJj¹ubj½)rÀ}rÁ(jIX *libexecdir*jO}rÂ(jQ]jR]jS]jT]jV]ujJj¹jD]rÃjbX libexecdirrÄ…rÅ}rÆ(jIUjJjÀubajMjÅubjbXj in which private executables are installed. For example, in the simple build system on Unix, the default rÇ…rÈ}rÉ(jIXj in which private executables are installed. For example, in the simple build system on Unix, the default jKNjXNjYhjJj¹ubj½)rÊ}rË(jIX *libexecdir*jO}rÌ(jQ]jR]jS]jT]jV]ujJj¹jD]rÍjbX libexecdirrÎ…rÏ}rÐ(jIUjJjÊubajMjÅubjbX is rÑ…rÒ}rÓ(jIX is jKNjXNjYhjJj¹ubj‚)rÔ}rÕ(jIX``/usr/local/libexec``jO}rÖ(jQ]jR]jS]jT]jV]ujJj¹jD]r×jbX/usr/local/libexecrØ…rÙ}rÚ(jIUjJjÔubajMjŠubjbX, and rÛ…rÜ}rÝ(jIX, and jKNjXNjYhjJj¹ubj½)rÞ}rß(jIX *libsubdir*jO}rà(jQ]jR]jS]jT]jV]ujJj¹jD]rájbX libsubdirrâ…rã}rä(jIUjJjÞubajMjÅubjbX is rå…ræ}rç(jIX is jKNjXNjYhjJj¹ubj‚)rè}ré(jIX&``x86_64-linux-ghc-8.0.2/mypkg-0.1.0``jO}rê(jQ]jR]jS]jT]jV]ujJj¹jD]rëjbX"x86_64-linux-ghc-8.0.2/mypkg-0.1.0rì…rí}rî(jIUjJjèubajMjŠubjbX/, so private executables would be installed in rï…rð}rñ(jIX/, so private executables would be installed in jKNjXNjYhjJj¹ubj‚)rò}ró(jIX:``/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/``jO}rô(jQ]jR]jS]jT]jV]ujJj¹jD]rõjbX6/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/rö…r÷}rø(jIUjJjòubajMjŠubeubjy)rù}rú(jIXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjµjKjLjMj|jO}rû(jQ]jR]jS]jT]jV]ujXMœjYhjD]rü(j½)rý}rþ(jIX*dir*jO}rÿ(jQ]jR]jS]jT]jV]ujJjùjD]rjbXdirr…r}r(jIUjJjýubajMjÅubjbX+ may contain the following path variables: r…r}r(jIX+ may contain the following path variables: jKNjXNjYhjJjùubj‚)r}r(jIX ``$pkgid``jO}r (jQ]jR]jS]jT]jV]ujJjùjD]r jbX$pkgidr …r }r (jIUjJjubajMjŠubjbX, r…r}r(jIX, rjKNjXNjYhjJjùubj‚)r}r(jIX``$pkg``jO}r(jQ]jR]jS]jT]jV]ujJjùjD]rjbX$pkgr…r}r(jIUjJjubajMjŠubjbX, r…r}r(jIX, rjKNjXNjYhjJjùubj‚)r}r(jIX ``$version``jO}r(jQ]jR]jS]jT]jV]ujJjùjD]r jbX$versionr!…r"}r#(jIUjJjubajMjŠubjbX, r$…r%}r&(jIX, jJjùubj‚)r'}r((jIX ``$compiler``jO}r)(jQ]jR]jS]jT]jV]ujJjùjD]r*jbX $compilerr+…r,}r-(jIUjJj'ubajMjŠubjbX, r.…r/}r0(jIX, jJjùubj‚)r1}r2(jIX``$os``jO}r3(jQ]jR]jS]jT]jV]ujJjùjD]r4jbX$osr5…r6}r7(jIUjJj1ubajMjŠubjbX, r8…r9}r:(jIX, jJjùubj‚)r;}r<(jIX ``$arch``jO}r=(jQ]jR]jS]jT]jV]ujJjùjD]r>jbX$archr?…r@}rA(jIUjJj;ubajMjŠubjbX, rB…rC}rD(jIjjJjùubj‚)rE}rF(jIX``$abi``jO}rG(jQ]jR]jS]jT]jV]ujJjùjD]rHjbX$abirI…rJ}rK(jIUjJjEubajMjŠubjbX, rL…rM}rN(jIjjJjùubj‚)rO}rP(jIX ``$abitag``jO}rQ(jQ]jR]jS]jT]jV]ujJjùjD]rRjbX$abitagrS…rT}rU(jIUjJjOubajMjŠubeubeubeubj’)rV}rW(jIUjJjõ jKjLjMj•jO}rX(jT]jS]jQ]jR]jV]Uentries]rY(j˜X5setup-configure command line option; --datasubdir=dirjUNtrZaujXNjYhjD]ubjš)r[}r\(jIUjJjõ jKjLjMjjO}r](jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr^j£j^ujXNjYhjD]r_(j¥)r`}ra(jIX--datasubdir=dirjJj[jKjLjMj¨jO}rb(jª]rcX --datasubdirrdajT]rejajS]jQ]jR]jV]rfh`aj°‰ujXM¨jYhjD]rg(j²)rh}ri(jIjdjJj`jKjLjMjµjO}rj(j½j¾jT]jS]jQ]jR]jV]ujXM¨jYhjD]rkjbX --datasubdirrl…rm}rn(jIUjKNjXNjYhjJjhubaubj»)ro}rp(jIX=dirjJj`jKjLjMj¾jO}rq(j½j¾jT]jS]jQ]jR]jV]ujXM¨jYhjD]rrjbX=dirrs…rt}ru(jIUjKNjXNjYhjJjoubaubeubjÖ)rv}rw(jIUjJj[jKjLjMjÙjO}rx(jQ]jR]jS]jT]jV]ujXM¨jYhjD]ry(jy)rz}r{(jIXGA subdirectory of *datadir* in which data files are actually installed.jJjvjKjLjMj|jO}r|(jQ]jR]jS]jT]jV]ujXM¢jYhjD]r}(jbXA subdirectory of r~…r}r€(jIXA subdirectory of jKNjXNjYhjJjzubj½)r}r‚(jIX *datadir*jO}rƒ(jQ]jR]jS]jT]jV]ujJjzjD]r„jbXdatadirr……r†}r‡(jIUjJjubajMjÅubjbX, in which data files are actually installed.rˆ…r‰}rŠ(jIX, in which data files are actually installed.jKNjXNjYhjJjzubeubjy)r‹}rŒ(jIXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjvjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM¥jYhjD]rŽ(j½)r}r(jIX*dir*jO}r‘(jQ]jR]jS]jT]jV]ujJj‹jD]r’jbXdirr“…r”}r•(jIUjJjubajMjÅubjbX+ may contain the following path variables: r–…r—}r˜(jIX+ may contain the following path variables: jKNjXNjYhjJj‹ubj‚)r™}rš(jIX ``$pkgid``jO}r›(jQ]jR]jS]jT]jV]ujJj‹jD]rœjbX$pkgidr…rž}rŸ(jIUjJj™ubajMjŠubjbX, r …r¡}r¢(jIX, r£jKNjXNjYhjJj‹ubj‚)r¤}r¥(jIX``$pkg``jO}r¦(jQ]jR]jS]jT]jV]ujJj‹jD]r§jbX$pkgr¨…r©}rª(jIUjJj¤ubajMjŠubjbX, r«…r¬}r­(jIX, r®jKNjXNjYhjJj‹ubj‚)r¯}r°(jIX ``$version``jO}r±(jQ]jR]jS]jT]jV]ujJj‹jD]r²jbX$versionr³…r´}rµ(jIUjJj¯ubajMjŠubjbX, r¶…r·}r¸(jIX, jJj‹ubj‚)r¹}rº(jIX ``$compiler``jO}r»(jQ]jR]jS]jT]jV]ujJj‹jD]r¼jbX $compilerr½…r¾}r¿(jIUjJj¹ubajMjŠubjbX, rÀ…rÁ}rÂ(jIX, jJj‹ubj‚)rÃ}rÄ(jIX``$os``jO}rÅ(jQ]jR]jS]jT]jV]ujJj‹jD]rÆjbX$osrÇ…rÈ}rÉ(jIUjJjÃubajMjŠubjbX, rÊ…rË}rÌ(jIX, jJj‹ubj‚)rÍ}rÎ(jIX ``$arch``jO}rÏ(jQ]jR]jS]jT]jV]ujJj‹jD]rÐjbX$archrÑ…rÒ}rÓ(jIUjJjÍubajMjŠubjbX, rÔ…rÕ}rÖ(jIj®jJj‹ubj‚)r×}rØ(jIX``$abi``jO}rÙ(jQ]jR]jS]jT]jV]ujJj‹jD]rÚjbX$abirÛ…rÜ}rÝ(jIUjJj×ubajMjŠubjbX, rÞ…rß}rà(jIj£jJj‹ubj‚)rá}râ(jIX ``$abitag``jO}rã(jQ]jR]jS]jT]jV]ujJj‹jD]räjbX$abitagrå…ræ}rç(jIUjJjáubajMjŠubeubeubeubj’)rè}ré(jIUjJjõ jKjLjMj•jO}rê(jT]jS]jQ]jR]jV]Uentries]rë(j˜X1setup-configure command line option; --docdir=dirj-UNtrìaujXNjYhjD]ubjš)rí}rî(jIUjJjõ jKjLjMjjO}rï(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrðj£jðujXNjYhjD]rñ(j¥)rò}ró(jIX --docdir=dirjJjíjKjLjMj¨jO}rô(jª]rõX--docdirröajT]r÷j-ajS]jQ]jR]jV]røhŒaj°‰ujXM±jYhjD]rù(j²)rú}rû(jIjöjJjòjKjLjMjµjO}rü(j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]rýjbX--docdirrþ…rÿ}r(jIUjKNjXNjYhjJjúubaubj»)r}r(jIX=dirjJjòjKjLjMj¾jO}r(j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]rjbX=dirr…r}r(jIUjKNjXNjYhjJjubaubeubjÖ)r}r (jIUjJjíjKjLjMjÙjO}r (jQ]jR]jS]jT]jV]ujXM±jYhjD]r (jy)r }r (jIX=Documentation files are installed relative to this directory.rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM«jYhjD]rjbX=Documentation files are installed relative to this directory.r…r}r(jIjjKNjXNjYhjJj ubaubjy)r}r(jIXâ*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM­jYhjD]r(j½)r}r(jIX*dir*jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXdirr…r}r(jIUjJjubajMjÅubjbX+ may contain the following path variables: r…r }r!(jIX+ may contain the following path variables: jKNjXNjYhjJjubj‚)r"}r#(jIX ``$prefix``jO}r$(jQ]jR]jS]jT]jV]ujJjjD]r%jbX$prefixr&…r'}r((jIUjJj"ubajMjŠubjbX, r)…r*}r+(jIX, r,jKNjXNjYhjJjubj‚)r-}r.(jIX ``$bindir``jO}r/(jQ]jR]jS]jT]jV]ujJjjD]r0jbX$bindirr1…r2}r3(jIUjJj-ubajMjŠubjbX, r4…r5}r6(jIX, r7jKNjXNjYhjJjubj‚)r8}r9(jIX ``$libdir``jO}r:(jQ]jR]jS]jT]jV]ujJjjD]r;jbX$libdirr<…r=}r>(jIUjJj8ubajMjŠubjbX, r?…r@}rA(jIX, jJjubj‚)rB}rC(jIX``$libsubdir``jO}rD(jQ]jR]jS]jT]jV]ujJjjD]rEjbX $libsubdirrF…rG}rH(jIUjJjBubajMjŠubjbX, rI…rJ}rK(jIX, jJjubj‚)rL}rM(jIX ``$datadir``jO}rN(jQ]jR]jS]jT]jV]ujJjjD]rOjbX$datadirrP…rQ}rR(jIUjJjLubajMjŠubjbX, rS…rT}rU(jIX, jJjubj‚)rV}rW(jIX``$datasubdir``jO}rX(jQ]jR]jS]jT]jV]ujJjjD]rYjbX $datasubdirrZ…r[}r\(jIUjJjVubajMjŠubjbX, r]…r^}r_(jIX, jJjubj‚)r`}ra(jIX ``$pkgid``jO}rb(jQ]jR]jS]jT]jV]ujJjjD]rcjbX$pkgidrd…re}rf(jIUjJj`ubajMjŠubjbX, rg…rh}ri(jIX, jJjubj‚)rj}rk(jIX``$pkg``jO}rl(jQ]jR]jS]jT]jV]ujJjjD]rmjbX$pkgrn…ro}rp(jIUjJjjubajMjŠubjbX, rq…rr}rs(jIX, jJjubj‚)rt}ru(jIX ``$version``jO}rv(jQ]jR]jS]jT]jV]ujJjjD]rwjbX$versionrx…ry}rz(jIUjJjtubajMjŠubjbX, r{…r|}r}(jIX, jJjubj‚)r~}r(jIX ``$compiler``jO}r€(jQ]jR]jS]jT]jV]ujJjjD]rjbX $compilerr‚…rƒ}r„(jIUjJj~ubajMjŠubjbX, r……r†}r‡(jIj,jJjubj‚)rˆ}r‰(jIX``$os``jO}rŠ(jQ]jR]jS]jT]jV]ujJjjD]r‹jbX$osrŒ…r}rŽ(jIUjJjˆubajMjŠubjbX, r…r}r‘(jIX, jJjubj‚)r’}r“(jIX ``$arch``jO}r”(jQ]jR]jS]jT]jV]ujJjjD]r•jbX$archr–…r—}r˜(jIUjJj’ubajMjŠubjbX, r™…rš}r›(jIX, jJjubj‚)rœ}r(jIX``$abi``jO}rž(jQ]jR]jS]jT]jV]ujJjjD]rŸjbX$abir …r¡}r¢(jIUjJjœubajMjŠubjbX, r£…r¤}r¥(jIj7jJjubj‚)r¦}r§(jIX ``$abitag``jO}r¨(jQ]jR]jS]jT]jV]ujJjjD]r©jbX$abitagrª…r«}r¬(jIUjJj¦ubajMjŠubeubeubeubj’)r­}r®(jIUjJjõ jKjLjMj•jO}r¯(jT]jS]jQ]jR]jV]Uentries]r°(j˜X2setup-configure command line option; --htmldir=dirhÚUNtr±aujXNjYhjD]ubjš)r²}r³(jIUjJjõ jKjLjMjjO}r´(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrµj£jµujXNjYhjD]r¶(j¥)r·}r¸(jIX --htmldir=dirjJj²jKjLjMj¨jO}r¹(jª]rºX --htmldirr»ajT]r¼hÚajS]jQ]jR]jV]r½h3aj°‰ujXMºjYhjD]r¾(j²)r¿}rÀ(jIj»jJj·jKjLjMjµjO}rÁ(j½j¾jT]jS]jQ]jR]jV]ujXMºjYhjD]rÂjbX --htmldirrÃ…rÄ}rÅ(jIUjKNjXNjYhjJj¿ubaubj»)rÆ}rÇ(jIX=dirjJj·jKjLjMj¾jO}rÈ(j½j¾jT]jS]jQ]jR]jV]ujXMºjYhjD]rÉjbX=dirrÊ…rË}rÌ(jIUjKNjXNjYhjJjÆubaubeubjÖ)rÍ}rÎ(jIUjJj²jKjLjMjÙjO}rÏ(jQ]jR]jS]jT]jV]ujXMºjYhjD]rÐ(jy)rÑ}rÒ(jIXBHTML documentation files are installed relative to this directory.rÓjJjÍjKjLjMj|jO}rÔ(jQ]jR]jS]jT]jV]ujXM´jYhjD]rÕjbXBHTML documentation files are installed relative to this directory.rÖ…r×}rØ(jIjÓjKNjXNjYhjJjÑubaubjy)rÙ}rÚ(jIXï*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$docdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjÍjKjLjMj|jO}rÛ(jQ]jR]jS]jT]jV]ujXM¶jYhjD]rÜ(j½)rÝ}rÞ(jIX*dir*jO}rß(jQ]jR]jS]jT]jV]ujJjÙjD]ràjbXdirrá…râ}rã(jIUjJjÝubajMjÅubjbX+ may contain the following path variables: rä…rå}ræ(jIX+ may contain the following path variables: jKNjXNjYhjJjÙubj‚)rç}rè(jIX ``$prefix``jO}ré(jQ]jR]jS]jT]jV]ujJjÙjD]rêjbX$prefixrë…rì}rí(jIUjJjçubajMjŠubjbX, rî…rï}rð(jIX, rñjKNjXNjYhjJjÙubj‚)rò}ró(jIX ``$bindir``jO}rô(jQ]jR]jS]jT]jV]ujJjÙjD]rõjbX$bindirrö…r÷}rø(jIUjJjòubajMjŠubjbX, rù…rú}rû(jIX, rüjKNjXNjYhjJjÙubj‚)rý}rþ(jIX ``$libdir``jO}rÿ(jQ]jR]jS]jT]jV]ujJjÙjD]rjbX$libdirr…r}r(jIUjJjýubajMjŠubjbX, r…r}r(jIX, jJjÙubj‚)r}r(jIX``$libsubdir``jO}r (jQ]jR]jS]jT]jV]ujJjÙjD]r jbX $libsubdirr …r }r (jIUjJjubajMjŠubjbX, r…r}r(jIX, jJjÙubj‚)r}r(jIX ``$datadir``jO}r(jQ]jR]jS]jT]jV]ujJjÙjD]rjbX$datadirr…r}r(jIUjJjubajMjŠubjbX, r…r}r(jIX, jJjÙubj‚)r}r(jIX``$datasubdir``jO}r(jQ]jR]jS]jT]jV]ujJjÙjD]rjbX $datasubdirr…r }r!(jIUjJjubajMjŠubjbX, r"…r#}r$(jIX, jJjÙubj‚)r%}r&(jIX ``$docdir``jO}r'(jQ]jR]jS]jT]jV]ujJjÙjD]r(jbX$docdirr)…r*}r+(jIUjJj%ubajMjŠubjbX, r,…r-}r.(jIX, jJjÙubj‚)r/}r0(jIX ``$pkgid``jO}r1(jQ]jR]jS]jT]jV]ujJjÙjD]r2jbX$pkgidr3…r4}r5(jIUjJj/ubajMjŠubjbX, r6…r7}r8(jIX, jJjÙubj‚)r9}r:(jIX``$pkg``jO}r;(jQ]jR]jS]jT]jV]ujJjÙjD]r<jbX$pkgr=…r>}r?(jIUjJj9ubajMjŠubjbX, r@…rA}rB(jIX, jJjÙubj‚)rC}rD(jIX ``$version``jO}rE(jQ]jR]jS]jT]jV]ujJjÙjD]rFjbX$versionrG…rH}rI(jIUjJjCubajMjŠubjbX, rJ…rK}rL(jIjñjJjÙubj‚)rM}rN(jIX ``$compiler``jO}rO(jQ]jR]jS]jT]jV]ujJjÙjD]rPjbX $compilerrQ…rR}rS(jIUjJjMubajMjŠubjbX, rT…rU}rV(jIX, jJjÙubj‚)rW}rX(jIX``$os``jO}rY(jQ]jR]jS]jT]jV]ujJjÙjD]rZjbX$osr[…r\}r](jIUjJjWubajMjŠubjbX, r^…r_}r`(jIX, jJjÙubj‚)ra}rb(jIX ``$arch``jO}rc(jQ]jR]jS]jT]jV]ujJjÙjD]rdjbX$archre…rf}rg(jIUjJjaubajMjŠubjbX, rh…ri}rj(jIX, jJjÙubj‚)rk}rl(jIX``$abi``jO}rm(jQ]jR]jS]jT]jV]ujJjÙjD]rnjbX$abiro…rp}rq(jIUjJjkubajMjŠubjbX, rr…rs}rt(jIjüjJjÙubj‚)ru}rv(jIX ``$abitag``jO}rw(jQ]jR]jS]jT]jV]ujJjÙjD]rxjbX$abitagry…rz}r{(jIUjJjuubajMjŠubeubeubeubj’)r|}r}(jIUjJjõ jKjLjMj•jO}r~(jT]jS]jQ]jR]jV]Uentries]r(j˜X<setup-configure command line option; --program-prefix=prefixhÜUNtr€aujXNjYhjD]ubjš)r}r‚(jIUjJjõ jKjLjMjjO}rƒ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr„j£j„ujXNjYhjD]r…(j¥)r†}r‡(jIX--program-prefix=prefixjJjjKjLjMj¨jO}rˆ(jª]r‰X--program-prefixrŠajT]r‹hÜajS]jQ]jR]jV]rŒh5aj°‰ujXMÂjYhjD]r(j²)rŽ}r(jIjŠjJj†jKjLjMjµjO}r(j½j¾jT]jS]jQ]jR]jV]ujXMÂjYhjD]r‘jbX--program-prefixr’…r“}r”(jIUjKNjXNjYhjJjŽubaubj»)r•}r–(jIX=prefixjJj†jKjLjMj¾jO}r—(j½j¾jT]jS]jQ]jR]jV]ujXMÂjYhjD]r˜jbX=prefixr™…rš}r›(jIUjKNjXNjYhjJj•ubaubeubjÖ)rœ}r(jIUjJjjKjLjMjÙjO}rž(jQ]jR]jS]jT]jV]ujXMÂjYhjD]rŸ(jy)r }r¡(jIX,Prepend *prefix* to installed program names.jJjœjKjLjMj|jO}r¢(jQ]jR]jS]jT]jV]ujXM½jYhjD]r£(jbXPrepend r¤…r¥}r¦(jIXPrepend jKNjXNjYhjJj ubj½)r§}r¨(jIX*prefix*jO}r©(jQ]jR]jS]jT]jV]ujJj jD]rªjbXprefixr«…r¬}r­(jIUjJj§ubajMjÅubjbX to installed program names.r®…r¯}r°(jIX to installed program names.jKNjXNjYhjJj ubeubjy)r±}r²(jIX*prefix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJjœjKjLjMj|jO}r³(jQ]jR]jS]jT]jV]ujXM¿jYhjD]r´(j½)rµ}r¶(jIX*prefix*jO}r·(jQ]jR]jS]jT]jV]ujJj±jD]r¸jbXprefixr¹…rº}r»(jIUjJjµubajMjÅubjbX+ may contain the following path variables: r¼…r½}r¾(jIX+ may contain the following path variables: jKNjXNjYhjJj±ubj‚)r¿}rÀ(jIX ``$pkgid``jO}rÁ(jQ]jR]jS]jT]jV]ujJj±jD]rÂjbX$pkgidrÃ…rÄ}rÅ(jIUjJj¿ubajMjŠubjbX, rÆ…rÇ}rÈ(jIX, rÉjKNjXNjYhjJj±ubj‚)rÊ}rË(jIX``$pkg``jO}rÌ(jQ]jR]jS]jT]jV]ujJj±jD]rÍjbX$pkgrÎ…rÏ}rÐ(jIUjJjÊubajMjŠubjbX, rÑ…rÒ}rÓ(jIX, rÔjKNjXNjYhjJj±ubj‚)rÕ}rÖ(jIX ``$version``jO}r×(jQ]jR]jS]jT]jV]ujJj±jD]rØjbX$versionrÙ…rÚ}rÛ(jIUjJjÕubajMjŠubjbX, rÜ…rÝ}rÞ(jIX, jJj±ubj‚)rß}rà(jIX ``$compiler``jO}rá(jQ]jR]jS]jT]jV]ujJj±jD]râjbX $compilerrã…rä}rå(jIUjJjßubajMjŠubjbX, ræ…rç}rè(jIX, jJj±ubj‚)ré}rê(jIX``$os``jO}rë(jQ]jR]jS]jT]jV]ujJj±jD]rìjbX$osrí…rî}rï(jIUjJjéubajMjŠubjbX, rð…rñ}rò(jIX, jJj±ubj‚)ró}rô(jIX ``$arch``jO}rõ(jQ]jR]jS]jT]jV]ujJj±jD]röjbX$archr÷…rø}rù(jIUjJjóubajMjŠubjbX, rú…rû}rü(jIjÔjJj±ubj‚)rý}rþ(jIX``$abi``jO}rÿ(jQ]jR]jS]jT]jV]ujJj±jD]rjbX$abir…r}r(jIUjJjýubajMjŠubjbX, r…r}r(jIjÉjJj±ubj‚)r}r(jIX ``$abitag``jO}r (jQ]jR]jS]jT]jV]ujJj±jD]r jbX$abitagr …r }r (jIUjJjubajMjŠubeubeubeubj’)r}r(jIUjJjõ jKjLjMj•jO}r(jT]jS]jQ]jR]jV]Uentries]r(j˜X<setup-configure command line option; --program-suffix=suffixj.UNtraujXNjYhjD]ubjš)r}r(jIUjJjõ jKjLjMjjO}r(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrj£jujXNjYhjD]r(j¥)r}r(jIX--program-suffix=suffixjJjjKjLjMj¨jO}r(jª]rX--program-suffixrajT]rj.ajS]jQ]jR]jV]rhaj°‰ujXMÍjYhjD]r(j²)r }r!(jIjjJjjKjLjMjµjO}r"(j½j¾jT]jS]jQ]jR]jV]ujXMÍjYhjD]r#jbX--program-suffixr$…r%}r&(jIUjKNjXNjYhjJj ubaubj»)r'}r((jIX=suffixjJjjKjLjMj¾jO}r)(j½j¾jT]jS]jQ]jR]jV]ujXMÍjYhjD]r*jbX=suffixr+…r,}r-(jIUjKNjXNjYhjJj'ubaubeubjÖ)r.}r/(jIUjJjjKjLjMjÙjO}r0(jQ]jR]jS]jT]jV]ujXMÍjYhjD]r1(jy)r2}r3(jIXÚ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'``.jJj.jKjLjMj|jO}r4(jQ]jR]jS]jT]jV]ujXMÅjYhjD]r5(jbXAppend r6…r7}r8(jIXAppend jKNjXNjYhjJj2ubj½)r9}r:(jIX*suffix*jO}r;(jQ]jR]jS]jT]jV]ujJj2jD]r<jbXsuffixr=…r>}r?(jIUjJj9ubajMjÅubjbX­ 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: r@…rA}rB(jIX« 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: jKNjXNjYhjJj2ubj‚)rC}rD(jIX``--program-suffix='$version'``jO}rE(jQ]jR]jS]jT]jV]ujJj2jD]rFjbX--program-suffix='$version'rG…rH}rI(jIUjJjCubajMjŠubjbX.…rJ}rK(jIX.jKNjXNjYhjJj2ubeubjy)rL}rM(jIX*suffix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jJj.jKjLjMj|jO}rN(jQ]jR]jS]jT]jV]ujXMÊjYhjD]rO(j½)rP}rQ(jIX*suffix*jO}rR(jQ]jR]jS]jT]jV]ujJjLjD]rSjbXsuffixrT…rU}rV(jIUjJjPubajMjÅubjbX+ may contain the following path variables: rW…rX}rY(jIX+ may contain the following path variables: jKNjXNjYhjJjLubj‚)rZ}r[(jIX ``$pkgid``jO}r\(jQ]jR]jS]jT]jV]ujJjLjD]r]jbX$pkgidr^…r_}r`(jIUjJjZubajMjŠubjbX, ra…rb}rc(jIX, rdjKNjXNjYhjJjLubj‚)re}rf(jIX``$pkg``jO}rg(jQ]jR]jS]jT]jV]ujJjLjD]rhjbX$pkgri…rj}rk(jIUjJjeubajMjŠubjbX, rl…rm}rn(jIX, rojKNjXNjYhjJjLubj‚)rp}rq(jIX ``$version``jO}rr(jQ]jR]jS]jT]jV]ujJjLjD]rsjbX$versionrt…ru}rv(jIUjJjpubajMjŠubjbX, rw…rx}ry(jIX, jJjLubj‚)rz}r{(jIX ``$compiler``jO}r|(jQ]jR]jS]jT]jV]ujJjLjD]r}jbX $compilerr~…r}r€(jIUjJjzubajMjŠubjbX, r…r‚}rƒ(jIX, jJjLubj‚)r„}r…(jIX``$os``jO}r†(jQ]jR]jS]jT]jV]ujJjLjD]r‡jbX$osrˆ…r‰}rŠ(jIUjJj„ubajMjŠubjbX, r‹…rŒ}r(jIX, jJjLubj‚)rŽ}r(jIX ``$arch``jO}r(jQ]jR]jS]jT]jV]ujJjLjD]r‘jbX$archr’…r“}r”(jIUjJjŽubajMjŠubjbX, r•…r–}r—(jIjojJjLubj‚)r˜}r™(jIX``$abi``jO}rš(jQ]jR]jS]jT]jV]ujJjLjD]r›jbX$abirœ…r}rž(jIUjJj˜ubajMjŠubjbX, rŸ…r }r¡(jIjdjJjLubj‚)r¢}r£(jIX ``$abitag``jO}r¤(jQ]jR]jS]jT]jV]ujJjLjD]r¥jbX$abitagr¦…r§}r¨(jIUjJj¢ubajMjŠubeubeubeubjF)r©}rª(jIUjJjõ jKjLjMjNjO}r«(jQ]jR]jS]jT]r¬hÝajV]r­h6aujXMÏjYhjD]r®(j[)r¯}r°(jIX)Path variables in the simple build systemr±jJj©jKjLjMj_jO}r²(jQ]jR]jS]jT]jV]ujXMÏjYhjD]r³jbX)Path variables in the simple build systemr´…rµ}r¶(jIj±jKNjXNjYhjJj¯ubaubjy)r·}r¸(jIX»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>`__).jJj©jKjLjMj|jO}r¹(jQ]jR]jS]jT]jV]ujXMÑjYhjD]rº(jbXì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½(jIXì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 jKNjXNjYhjJj·ubj‚)r¾}r¿(jIX ``$prefix``jO}rÀ(jQ]jR]jS]jT]jV]ujJj·jD]rÁjbX$prefixrÂ…rÃ}rÄ(jIUjJj¾ubajMjŠubjbX”. 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Ç(jIX”. This allows paths to be specified relative to each other rather than as absolute paths, which is important for building relocatable packages (see jKNjXNjYhjJj·ubjœ)rÈ}rÉ(jIX.`prefix independence <#prefix-independence>`__jO}rÊ(UnameXprefix independencejêX#prefix-independencejT]jS]jQ]jR]jV]ujJj·jD]rËjbXprefix independencerÌ…rÍ}rÎ(jIUjJjÈubajMj¥ubjbX).rÏ…rÐ}rÑ(jIX).jKNjXNjYhjJj·ubeubcdocutils.nodes definition_list rÒ)rÓ}rÔ(jIUjJj©jKjLjMUdefinition_listrÕjO}rÖ(jQ]jR]jS]jT]jV]ujXNjYhjD]r×(cdocutils.nodes definition_list_item rØ)rÙ}rÚ(jIX¹$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.jJjÓjKjLjMUdefinition_list_itemrÛjO}rÜ(jQ]jR]jS]jT]jV]ujXMÛjD]rÝ(cdocutils.nodes term rÞ)rß}rà(jIX$prefixrájJjÙjKjLjMUtermrâjO}rã(jQ]jR]jS]jT]jV]ujXMÛjD]räjbX$prefixrå…ræ}rç(jIjájJjßubaubcdocutils.nodes definition rè)ré}rê(jIUjO}rë(jQ]jR]jS]jT]jV]ujJjÙjD]rìjy)rí}rî(jIX±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.jJjéjKjLjMj|jO}rï(jQ]jR]jS]jT]jV]ujXMÚjD]rð(jbXœ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ó(jIXœ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 jJjíubj‚)rô}rõ(jIX ``$prefix``jO}rö(jQ]jR]jS]jT]jV]ujJjíjD]r÷jbX$prefixrø…rù}rú(jIUjJjôubajMjŠubjbX variable.rû…rü}rý(jIX variable.jJjíubeubajMU definitionrþubeubjØ)rÿ}r(jIXu$bindir The path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jJjÓjKjLjMjÛjO}r(jQ]jR]jS]jT]jV]ujXMÞjYhjD]r(jÞ)r}r(jIX$bindirrjJjÿjKjLjMjâjO}r(jQ]jR]jS]jT]jV]ujXMÞjD]rjbX$bindirr…r }r (jIjjJjubaubjè)r }r (jIUjO}r (jQ]jR]jS]jT]jV]ujJjÿjD]rjy)r}r(jIXmThe path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jJj jKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMÞjD]r(jbX8The path variable that expands to the path given by the r…r}r(jIX8The path variable that expands to the path given by the jJjubj­)r}r(jIX:option:`--bindir`rjJjjKjLjMj±jO}r(UreftypeXoptionj³ˆj´X--bindirU refdomainXstdrjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÞjD]rj‚)r}r(jIjjO}r(jQ]jR]r(j¾jX std-optionr ejS]jT]jV]ujJjjD]r!jbX--bindirr"…r#}r$(jIUjJjubajMjŠubaubjbX# configure option (or the default).r%…r&}r'(jIX# configure option (or the default).jJjubeubajMjþubeubjØ)r(}r)(jIX+$libdir As above but for :option:`--libdir`jJjÓjKjLjMjÛjO}r*(jQ]jR]jS]jT]jV]ujXMàjYhjD]r+(jÞ)r,}r-(jIX$libdirr.jJj(jKjLjMjâjO}r/(jQ]jR]jS]jT]jV]ujXMàjD]r0jbX$libdirr1…r2}r3(jIj.jJj,ubaubjè)r4}r5(jIUjO}r6(jQ]jR]jS]jT]jV]ujJj(jD]r7jy)r8}r9(jIX#As above but for :option:`--libdir`jJj4jKjLjMj|jO}r:(jQ]jR]jS]jT]jV]ujXMájD]r;(jbXAs above but for r<…r=}r>(jIXAs above but for jJj8ubj­)r?}r@(jIX:option:`--libdir`rAjJj8jKjLjMj±jO}rB(UreftypeXoptionj³ˆj´X--libdirU refdomainXstdrCjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMájD]rDj‚)rE}rF(jIjAjO}rG(jQ]jR]rH(j¾jCX std-optionrIejS]jT]jV]ujJj?jD]rJjbX--libdirrK…rL}rM(jIUjJjEubajMjŠubaubeubajMjþubeubjØ)rN}rO(jIX1$libsubdir As above but for :option:`--libsubdir`jJjÓjKjLjMjÛjO}rP(jQ]jR]jS]jT]jV]ujXMâjYhjD]rQ(jÞ)rR}rS(jIX $libsubdirrTjJjNjKjLjMjâjO}rU(jQ]jR]jS]jT]jV]ujXMâjD]rVjbX $libsubdirrW…rX}rY(jIjTjJjRubaubjè)rZ}r[(jIUjO}r\(jQ]jR]jS]jT]jV]ujJjNjD]r]jy)r^}r_(jIX&As above but for :option:`--libsubdir`jJjZjKjLjMj|jO}r`(jQ]jR]jS]jT]jV]ujXMãjD]ra(jbXAs above but for rb…rc}rd(jIXAs above but for jJj^ubj­)re}rf(jIX:option:`--libsubdir`rgjJj^jKjLjMj±jO}rh(UreftypeXoptionj³ˆj´X --libsubdirU refdomainXstdrijT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMãjD]rjj‚)rk}rl(jIjgjO}rm(jQ]jR]rn(j¾jiX std-optionroejS]jT]jV]ujJjejD]rpjbX --libsubdirrq…rr}rs(jIUjJjkubajMjŠubaubeubajMjþubeubjØ)rt}ru(jIX1$dynlibdir As above but for :option:`--dynlibdir`jJjÓjKjLjMjÛjO}rv(jQ]jR]jS]jT]jV]ujXMäjYhjD]rw(jÞ)rx}ry(jIX $dynlibdirrzjJjtjKjLjMjâjO}r{(jQ]jR]jS]jT]jV]ujXMäjD]r|jbX $dynlibdirr}…r~}r(jIjzjJjxubaubjè)r€}r(jIUjO}r‚(jQ]jR]jS]jT]jV]ujJjtjD]rƒjy)r„}r…(jIX&As above but for :option:`--dynlibdir`jJj€jKjLjMj|jO}r†(jQ]jR]jS]jT]jV]ujXMåjD]r‡(jbXAs above but for rˆ…r‰}rŠ(jIXAs above but for jJj„ubj­)r‹}rŒ(jIX:option:`--dynlibdir`rjJj„jKjLjMj±jO}rŽ(UreftypeXoptionj³ˆj´X --dynlibdirU refdomainXstdrjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMåjD]rj‚)r‘}r’(jIjjO}r“(jQ]jR]r”(j¾jX std-optionr•ejS]jT]jV]ujJj‹jD]r–jbX --dynlibdirr—…r˜}r™(jIUjJj‘ubajMjŠubaubeubajMjþubeubjØ)rš}r›(jIX-$datadir As above but for :option:`--datadir`jJjÓjKjLjMjÛjO}rœ(jQ]jR]jS]jT]jV]ujXMæjYhjD]r(jÞ)rž}rŸ(jIX$datadirr jJjšjKjLjMjâjO}r¡(jQ]jR]jS]jT]jV]ujXMæjD]r¢jbX$datadirr£…r¤}r¥(jIj jJjžubaubjè)r¦}r§(jIUjO}r¨(jQ]jR]jS]jT]jV]ujJjšjD]r©jy)rª}r«(jIX$As above but for :option:`--datadir`jJj¦jKjLjMj|jO}r¬(jQ]jR]jS]jT]jV]ujXMçjD]r­(jbXAs above but for r®…r¯}r°(jIXAs above but for jJjªubj­)r±}r²(jIX:option:`--datadir`r³jJjªjKjLjMj±jO}r´(UreftypeXoptionj³ˆj´X --datadirU refdomainXstdrµjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMçjD]r¶j‚)r·}r¸(jIj³jO}r¹(jQ]jR]rº(j¾jµX std-optionr»ejS]jT]jV]ujJj±jD]r¼jbX --datadirr½…r¾}r¿(jIUjJj·ubajMjŠubaubeubajMjþubeubjØ)rÀ}rÁ(jIX3$datasubdir As above but for :option:`--datasubdir`jJjÓjKjLjMjÛjO}rÂ(jQ]jR]jS]jT]jV]ujXMèjYhjD]rÃ(jÞ)rÄ}rÅ(jIX $datasubdirrÆjJjÀjKjLjMjâjO}rÇ(jQ]jR]jS]jT]jV]ujXMèjD]rÈjbX $datasubdirrÉ…rÊ}rË(jIjÆjJjÄubaubjè)rÌ}rÍ(jIUjO}rÎ(jQ]jR]jS]jT]jV]ujJjÀjD]rÏjy)rÐ}rÑ(jIX'As above but for :option:`--datasubdir`jJjÌjKjLjMj|jO}rÒ(jQ]jR]jS]jT]jV]ujXMéjD]rÓ(jbXAs above but for rÔ…rÕ}rÖ(jIXAs above but for jJjÐubj­)r×}rØ(jIX:option:`--datasubdir`rÙjJjÐjKjLjMj±jO}rÚ(UreftypeXoptionj³ˆj´X --datasubdirU refdomainXstdrÛjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMéjD]rÜj‚)rÝ}rÞ(jIjÙjO}rß(jQ]jR]rà(j¾jÛX std-optionráejS]jT]jV]ujJj×jD]râjbX --datasubdirrã…rä}rå(jIUjJjÝubajMjŠubaubeubajMjþubeubjØ)ræ}rç(jIX+$docdir As above but for :option:`--docdir`jJjÓjKjLjMjÛjO}rè(jQ]jR]jS]jT]jV]ujXMêjYhjD]ré(jÞ)rê}rë(jIX$docdirrìjJjæjKjLjMjâjO}rí(jQ]jR]jS]jT]jV]ujXMêjD]rîjbX$docdirrï…rð}rñ(jIjìjJjêubaubjè)rò}ró(jIUjO}rô(jQ]jR]jS]jT]jV]ujJjæjD]rõjy)rö}r÷(jIX#As above but for :option:`--docdir`jJjòjKjLjMj|jO}rø(jQ]jR]jS]jT]jV]ujXMëjD]rù(jbXAs above but for rú…rû}rü(jIXAs above but for jJjöubj­)rý}rþ(jIX:option:`--docdir`rÿjJjöjKjLjMj±jO}r(UreftypeXoptionj³ˆj´X--docdirU refdomainXstdrjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMëjD]rj‚)r}r(jIjÿjO}r(jQ]jR]r(j¾jX std-optionrejS]jT]jV]ujJjýjD]rjbX--docdirr …r }r (jIUjJjubajMjŠubaubeubajMjþubeubjØ)r }r (jIX>$pkgid The name and version of the package, e.g. ``mypkg-0.2``jJjÓjKjLjMjÛjO}r(jQ]jR]jS]jT]jV]ujXMìjYhjD]r(jÞ)r}r(jIX$pkgidrjJj jKjLjMjâjO}r(jQ]jR]jS]jT]jV]ujXMìjD]rjbX$pkgidr…r}r(jIjjJjubaubjè)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJj jD]rjy)r}r(jIX7The name and version of the package, e.g. ``mypkg-0.2``jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMíjD]r(jbX*The name and version of the package, e.g. r …r!}r"(jIX*The name and version of the package, e.g. jJjubj‚)r#}r$(jIX ``mypkg-0.2``jO}r%(jQ]jR]jS]jT]jV]ujJjjD]r&jbX mypkg-0.2r'…r(}r)(jIUjJj#ubajMjŠubeubajMjþubeubjØ)r*}r+(jIX,$pkg The name of the package, e.g. ``mypkg``jJjÓjKjLjMjÛjO}r,(jQ]jR]jS]jT]jV]ujXMîjYhjD]r-(jÞ)r.}r/(jIX$pkgr0jJj*jKjLjMjâjO}r1(jQ]jR]jS]jT]jV]ujXMîjD]r2jbX$pkgr3…r4}r5(jIj0jJj.ubaubjè)r6}r7(jIUjO}r8(jQ]jR]jS]jT]jV]ujJj*jD]r9jy)r:}r;(jIX'The name of the package, e.g. ``mypkg``jJj6jKjLjMj|jO}r<(jQ]jR]jS]jT]jV]ujXMïjD]r=(jbXThe name of the package, e.g. r>…r?}r@(jIXThe name of the package, e.g. jJj:ubj‚)rA}rB(jIX ``mypkg``jO}rC(jQ]jR]jS]jT]jV]ujJj:jD]rDjbXmypkgrE…rF}rG(jIUjJjAubajMjŠubeubajMjþubeubjØ)rH}rI(jIX1$version The version of the package, e.g. ``0.2``jJjÓjKjLjMjÛjO}rJ(jQ]jR]jS]jT]jV]ujXMðjYhjD]rK(jÞ)rL}rM(jIX$versionrNjJjHjKjLjMjâjO}rO(jQ]jR]jS]jT]jV]ujXMðjD]rPjbX$versionrQ…rR}rS(jIjNjJjLubaubjè)rT}rU(jIUjO}rV(jQ]jR]jS]jT]jV]ujJjHjD]rWjy)rX}rY(jIX(The version of the package, e.g. ``0.2``jJjTjKjLjMj|jO}rZ(jQ]jR]jS]jT]jV]ujXMñjD]r[(jbX!The version of the package, e.g. r\…r]}r^(jIX!The version of the package, e.g. jJjXubj‚)r_}r`(jIX``0.2``jO}ra(jQ]jR]jS]jT]jV]ujJjXjD]rbjbX0.2rc…rd}re(jIUjJj_ubajMjŠubeubajMjþubeubjØ)rf}rg(jIXJ$compiler The compiler being used to build the package, e.g. ``ghc-6.6.1``jJjÓjKjLjMjÛjO}rh(jQ]jR]jS]jT]jV]ujXMòjYhjD]ri(jÞ)rj}rk(jIX $compilerrljJjfjKjLjMjâjO}rm(jQ]jR]jS]jT]jV]ujXMòjD]rnjbX $compilerro…rp}rq(jIjljJjjubaubjè)rr}rs(jIUjO}rt(jQ]jR]jS]jT]jV]ujJjfjD]rujy)rv}rw(jIX@The compiler being used to build the package, e.g. ``ghc-6.6.1``jJjrjKjLjMj|jO}rx(jQ]jR]jS]jT]jV]ujXMójD]ry(jbX3The compiler being used to build the package, e.g. rz…r{}r|(jIX3The compiler being used to build the package, e.g. jJjvubj‚)r}}r~(jIX ``ghc-6.6.1``jO}r(jQ]jR]jS]jT]jV]ujJjvjD]r€jbX ghc-6.6.1r…r‚}rƒ(jIUjJj}ubajMjŠubeubajMjþubeubjØ)r„}r…(jIXŠ$os The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jJjÓjKjLjMjÛjO}r†(jQ]jR]jS]jT]jV]ujXMöjYhjD]r‡(jÞ)rˆ}r‰(jIX$osrŠjJj„jKjLjMjâjO}r‹(jQ]jR]jS]jT]jV]ujXMöjD]rŒjbX$osr…rŽ}r(jIjŠjJjˆubaubjè)r}r‘(jIUjO}r’(jQ]jR]jS]jT]jV]ujJj„jD]r“jy)r”}r•(jIX†The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jJjjKjLjMj|jO}r–(jQ]jR]jS]jT]jV]ujXMõjD]r—(jbXKThe operating system of the computer being used to build the package, e.g. r˜…r™}rš(jIXKThe operating system of the computer being used to build the package, e.g. jJj”ubj‚)r›}rœ(jIX ``linux``jO}r(jQ]jR]jS]jT]jV]ujJj”jD]ržjbXlinuxrŸ…r }r¡(jIUjJj›ubajMjŠubjbX, r¢…r£}r¤(jIX, r¥jJj”ubj‚)r¦}r§(jIX ``windows``jO}r¨(jQ]jR]jS]jT]jV]ujJj”jD]r©jbXwindowsrª…r«}r¬(jIUjJj¦ubajMjŠubjbX, r­…r®}r¯(jIX, jJj”ubj‚)r°}r±(jIX``osx``jO}r²(jQ]jR]jS]jT]jV]ujJj”jD]r³jbXosxr´…rµ}r¶(jIUjJj°ubajMjŠubjbX, r·…r¸}r¹(jIj¥jJj”ubj‚)rº}r»(jIX ``freebsd``jO}r¼(jQ]jR]jS]jT]jV]ujJj”jD]r½jbXfreebsdr¾…r¿}rÀ(jIUjJjºubajMjŠubjbX or rÁ…rÂ}rÃ(jIX or jJj”ubj‚)rÄ}rÅ(jIX ``solaris``jO}rÆ(jQ]jR]jS]jT]jV]ujJj”jD]rÇjbXsolarisrÈ…rÉ}rÊ(jIUjJjÄubajMjŠubeubajMjþubeubjØ)rË}rÌ(jIXw$arch The architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jJjÓjKjLjMjÛjO}rÍ(jQ]jR]jS]jT]jV]ujXMùjYhjD]rÎ(jÞ)rÏ}rÐ(jIX$archrÑjJjËjKjLjMjâjO}rÒ(jQ]jR]jS]jT]jV]ujXMùjD]rÓjbX$archrÔ…rÕ}rÖ(jIjÑjJjÏubaubjè)r×}rØ(jIUjO}rÙ(jQ]jR]jS]jT]jV]ujJjËjD]rÚjy)rÛ}rÜ(jIXqThe architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jJj×jKjLjMj|jO}rÝ(jQ]jR]jS]jT]jV]ujXMùjD]rÞ(jbXGThe architecture of the computer being used to build the package, e.g. rß…rà}rá(jIXGThe architecture of the computer being used to build the package, e.g. jJjÛubj‚)râ}rã(jIX``i386``jO}rä(jQ]jR]jS]jT]jV]ujJjÛjD]råjbXi386ræ…rç}rè(jIUjJjâubajMjŠubjbX, ré…rê}rë(jIX, rìjJjÛubj‚)rí}rî(jIX ``x86_64``jO}rï(jQ]jR]jS]jT]jV]ujJjÛjD]rðjbXx86_64rñ…rò}ró(jIUjJjíubajMjŠubjbX, rô…rõ}rö(jIjìjJjÛubj‚)r÷}rø(jIX``ppc``jO}rù(jQ]jR]jS]jT]jV]ujJjÛjD]rújbXppcrû…rü}rý(jIUjJj÷ubajMjŠubjbX or rþ…rÿ}r(jIX or jJjÛubj‚)r}r(jIX ``sparc``jO}r(jQ]jR]jS]jT]jV]ujJjÛjD]rjbXsparcr…r}r(jIUjJjubajMjŠubeubajMjþubeubjØ)r}r (jIX§$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.jJjÓjKjLjMjÛjO}r (jQ]jR]jS]jT]jV]ujXMýjYhjD]r (jÞ)r }r (jIX$abitagrjJjjKjLjMjâjO}r(jQ]jR]jS]jT]jV]ujXMýjD]rjbX$abitagr…r}r(jIjjJj ubaubjè)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjjD]rjy)r}r(jIXŸ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.rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMüjD]rjbX¡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(jIjjJjubaubajMjþubeubjØ)r }r!(jIXñ$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. jJjÓjKjLjMjÛjO}r"(jQ]jR]jS]jT]jV]ujXMjYhjD]r#(jÞ)r$}r%(jIX$abir&jJj jKjLjMjâjO}r'(jQ]jR]jS]jT]jV]ujXMjD]r(jbX$abir)…r*}r+(jIj&jJj$ubaubjè)r,}r-(jIUjO}r.(jQ]jR]jS]jT]jV]ujJj jD]r/jy)r0}r1(jIXë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.jJj,jKjLjMj|jO}r2(jQ]jR]jS]jT]jV]ujXMjD]r3(jbX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as r4…r5}r6(jIX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as jJj0ubj‚)r7}r8(jIX``$arch-$os-compiler-$abitag``jO}r9(jQ]jR]jS]jT]jV]ujJj0jD]r:jbX$arch-$os-compiler-$abitagr;…r<}r=(jIUjJj7ubajMjŠubjbX" if the compiler uses an abi tag, r>…r?}r@(jIX" if the compiler uses an abi tag, jJj0ubj‚)rA}rB(jIX``$arch-$os-$compiler``jO}rC(jQ]jR]jS]jT]jV]ujJj0jD]rDjbX$arch-$os-$compilerrE…rF}rG(jIUjJjAubajMjŠubjbX if it doesn’t.rH…rI}rJ(jIX if it doesn't.jJj0ubeubajMjþubeubeubeubjF)rK}rL(jIUjJjõ jKjLjMjNjO}rM(jQ]jR]jS]jT]rNhéajV]rOhCaujXMjYhjD]rP(j[)rQ}rR(jIX Paths in the simple build systemrSjJjKjKjLjMj_jO}rT(jQ]jR]jS]jT]jV]ujXMjYhjD]rUjbX Paths in the simple build systemrV…rW}rX(jIjSjKNjXNjYhjJjQubaubjy)rY}rZ(jIX:For the simple build system, the following defaults apply:r[jJjKjKjLjMj|jO}r\(jQ]jR]jS]jT]jV]ujXMjYhjD]r]jbX:For the simple build system, the following defaults apply:r^…r_}r`(jIj[jKNjXNjYhjJjYubaubcdocutils.nodes table ra)rb}rc(jIUjJjKjKNjMUtablerdjO}re(jQ]jR]jS]jT]rfUid11rgajV]ujXNjYhjD]rh(j[)ri}rj(jIXDefault installation pathsrkjJjbjKjLjMj_jO}rl(jQ]jR]jS]jT]jV]ujXM jD]rmjbXDefault installation pathsrn…ro}rp(jIjkjJjiubaubcdocutils.nodes tgroup rq)rr}rs(jIUjO}rt(jT]jS]jQ]jR]jV]UcolsKujJjbjD]ru(cdocutils.nodes colspec rv)rw}rx(jIUjO}ry(jT]jS]jQ]jR]jV]UcolwidthrzK!ujJjrjD]jMUcolspecr{ubjv)r|}r}(jIUjO}r~(jT]jS]jQ]jR]jV]jzK!ujJjrjD]jMj{ubjv)r}r€(jIUjO}r(jT]jS]jQ]jR]jV]jzK!ujJjrjD]jMj{ubcdocutils.nodes tbody r‚)rƒ}r„(jIUjO}r…(jQ]jR]jS]jT]jV]ujJjrjD]r†(cdocutils.nodes row r‡)rˆ}r‰(jIUjO}rŠ(jQ]jR]jS]jT]jV]ujJjƒjD]r‹(cdocutils.nodes entry rŒ)r}rŽ(jIUjO}r(jQ]jR]jS]jT]jV]ujJjˆjD]rjy)r‘}r’(jIXOptionr“jJjjKjLjMj|jO}r”(jQ]jR]jS]jT]jV]ujXM jD]r•jbXOptionr–…r—}r˜(jIj“jJj‘ubaubajMUentryr™ubjŒ)rš}r›(jIUjO}rœ(jQ]jR]jS]jT]jV]ujJjˆjD]rjy)rž}rŸ(jIX Unix Defaultr jJjšjKjLjMj|jO}r¡(jQ]jR]jS]jT]jV]ujXM jD]r¢jbX Unix Defaultr£…r¤}r¥(jIj jJjžubaubajMj™ubjŒ)r¦}r§(jIUjO}r¨(jQ]jR]jS]jT]jV]ujJjˆjD]r©jy)rª}r«(jIXWindows Defaultr¬jJj¦jKjLjMj|jO}r­(jQ]jR]jS]jT]jV]ujXMjD]r®jbXWindows Defaultr¯…r°}r±(jIj¬jJjªubaubajMj™ubejMUrowr²ubj‡)r³}r´(jIUjO}rµ(jQ]jR]jS]jT]jV]ujJjƒjD]r¶(jŒ)r·}r¸(jIUjO}r¹(jQ]jR]jS]jT]jV]ujJj³jD]rºjy)r»}r¼(jIX:option:`--prefix` (global)r½jJj·jKjLjMj|jO}r¾(jQ]jR]jS]jT]jV]ujXMjD]r¿(j­)rÀ}rÁ(jIX:option:`--prefix`rÂjJj»jKjLjMj±jO}rÃ(UreftypeXoptionj³ˆj´X--prefixU refdomainXstdrÄjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]rÅj‚)rÆ}rÇ(jIjÂjO}rÈ(jQ]jR]rÉ(j¾jÄX std-optionrÊejS]jT]jV]ujJjÀjD]rËjbX--prefixrÌ…rÍ}rÎ(jIUjJjÆubajMjŠubaubjbX (global)rÏ…rÐ}rÑ(jIX (global)jJj»ubeubajMj™ubjŒ)rÒ}rÓ(jIUjO}rÔ(jQ]jR]jS]jT]jV]ujJj³jD]rÕjy)rÖ}r×(jIX``/usr/local``rØjJjÒjKjLjMj|jO}rÙ(jQ]jR]jS]jT]jV]ujXMjD]rÚj‚)rÛ}rÜ(jIjØjO}rÝ(jQ]jR]jS]jT]jV]ujJjÖjD]rÞjbX /usr/localrß…rà}rá(jIUjJjÛubajMjŠubaubajMj™ubjŒ)râ}rã(jIUjO}rä(jQ]jR]jS]jT]jV]ujJj³jD]råjy)ræ}rç(jIX``%PROGRAMFILES%\Haskell``rèjJjâjKjLjMj|jO}ré(jQ]jR]jS]jT]jV]ujXMjD]rêj‚)rë}rì(jIX``%PROGRAMFILES%\Haskell``jO}rí(jQ]jR]jS]jT]jV]ujJjæjD]rîjbX%PROGRAMFILES%\Haskellrï…rð}rñ(jIUjJjëubajMjŠubaubajMj™ubejMj²ubj‡)rò}ró(jIUjO}rô(jQ]jR]jS]jT]jV]ujJjƒjD]rõ(jŒ)rö}r÷(jIUjO}rø(jQ]jR]jS]jT]jV]ujJjòjD]rùjy)rú}rû(jIX:option:`--prefix` (per-user)rüjJjöjKjLjMj|jO}rý(jQ]jR]jS]jT]jV]ujXMjD]rþ(j­)rÿ}r(jIX:option:`--prefix`rjJjújKjLjMj±jO}r(UreftypeXoptionj³ˆj´X--prefixU refdomainXstdrjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]rj‚)r}r(jIjjO}r(jQ]jR]r(j¾jX std-optionr ejS]jT]jV]ujJjÿjD]r jbX--prefixr …r }r (jIUjJjubajMjŠubaubjbX (per-user)r…r}r(jIX (per-user)jJjúubeubajMj™ubjŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjòjD]rjy)r}r(jIX``$HOME/.cabal``rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMjD]rj‚)r}r(jIjjO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbX $HOME/.cabalr…r}r (jIUjJjubajMjŠubaubajMj™ubjŒ)r!}r"(jIUjO}r#(jQ]jR]jS]jT]jV]ujJjòjD]r$jy)r%}r&(jIX``%APPDATA%\cabal``r'jJj!jKjLjMj|jO}r((jQ]jR]jS]jT]jV]ujXMjD]r)j‚)r*}r+(jIX``%APPDATA%\cabal``jO}r,(jQ]jR]jS]jT]jV]ujJj%jD]r-jbX%APPDATA%\cabalr.…r/}r0(jIUjJj*ubajMjŠubaubajMj™ubejMj²ubj‡)r1}r2(jIUjO}r3(jQ]jR]jS]jT]jV]ujJjƒjD]r4(jŒ)r5}r6(jIUjO}r7(jQ]jR]jS]jT]jV]ujJj1jD]r8jy)r9}r:(jIX:option:`--bindir`r;jJj5jKjLjMj|jO}r<(jQ]jR]jS]jT]jV]ujXMjD]r=j­)r>}r?(jIj;jJj9jKjLjMj±jO}r@(UreftypeXoptionj³ˆj´X--bindirU refdomainXstdrAjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]rBj‚)rC}rD(jIj;jO}rE(jQ]jR]rF(j¾jAX std-optionrGejS]jT]jV]ujJj>jD]rHjbX--bindirrI…rJ}rK(jIUjJjCubajMjŠubaubaubajMj™ubjŒ)rL}rM(jIUjO}rN(jQ]jR]jS]jT]jV]ujJj1jD]rOjy)rP}rQ(jIX``$prefix/bin``rRjJjLjKjLjMj|jO}rS(jQ]jR]jS]jT]jV]ujXMjD]rTj‚)rU}rV(jIjRjO}rW(jQ]jR]jS]jT]jV]ujJjPjD]rXjbX $prefix/binrY…rZ}r[(jIUjJjUubajMjŠubaubajMj™ubjŒ)r\}r](jIUjO}r^(jQ]jR]jS]jT]jV]ujJj1jD]r_jy)r`}ra(jIX``$prefix\bin``rbjJj\jKjLjMj|jO}rc(jQ]jR]jS]jT]jV]ujXMjD]rdj‚)re}rf(jIX``$prefix\bin``jO}rg(jQ]jR]jS]jT]jV]ujJj`jD]rhjbX $prefix\binri…rj}rk(jIUjJjeubajMjŠubaubajMj™ubejMj²ubj‡)rl}rm(jIUjO}rn(jQ]jR]jS]jT]jV]ujJjƒjD]ro(jŒ)rp}rq(jIUjO}rr(jQ]jR]jS]jT]jV]ujJjljD]rsjy)rt}ru(jIX:option:`--libdir`rvjJjpjKjLjMj|jO}rw(jQ]jR]jS]jT]jV]ujXMjD]rxj­)ry}rz(jIjvjJjtjKjLjMj±jO}r{(UreftypeXoptionj³ˆj´X--libdirU refdomainXstdr|jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]r}j‚)r~}r(jIjvjO}r€(jQ]jR]r(j¾j|X std-optionr‚ejS]jT]jV]ujJjyjD]rƒjbX--libdirr„…r…}r†(jIUjJj~ubajMjŠubaubaubajMj™ubjŒ)r‡}rˆ(jIUjO}r‰(jQ]jR]jS]jT]jV]ujJjljD]rŠjy)r‹}rŒ(jIX``$prefix/lib``rjJj‡jKjLjMj|jO}rŽ(jQ]jR]jS]jT]jV]ujXMjD]rj‚)r}r‘(jIjjO}r’(jQ]jR]jS]jT]jV]ujJj‹jD]r“jbX $prefix/libr”…r•}r–(jIUjJjubajMjŠubaubajMj™ubjŒ)r—}r˜(jIUjO}r™(jQ]jR]jS]jT]jV]ujJjljD]ršjy)r›}rœ(jIX ``$prefix``rjJj—jKjLjMj|jO}rž(jQ]jR]jS]jT]jV]ujXMjD]rŸj‚)r }r¡(jIjjO}r¢(jQ]jR]jS]jT]jV]ujJj›jD]r£jbX$prefixr¤…r¥}r¦(jIUjJj ubajMjŠubaubajMj™ubejMj²ubj‡)r§}r¨(jIUjO}r©(jQ]jR]jS]jT]jV]ujJjƒjD]rª(jŒ)r«}r¬(jIUjO}r­(jQ]jR]jS]jT]jV]ujJj§jD]r®jy)r¯}r°(jIX:option:`--libsubdir` (others)r±jJj«jKjLjMj|jO}r²(jQ]jR]jS]jT]jV]ujXMjD]r³(j­)r´}rµ(jIX:option:`--libsubdir`r¶jJj¯jKjLjMj±jO}r·(UreftypeXoptionj³ˆj´X --libsubdirU refdomainXstdr¸jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]r¹j‚)rº}r»(jIj¶jO}r¼(jQ]jR]r½(j¾j¸X std-optionr¾ejS]jT]jV]ujJj´jD]r¿jbX --libsubdirrÀ…rÁ}rÂ(jIUjJjºubajMjŠubaubjbX (others)rÃ…rÄ}rÅ(jIX (others)jJj¯ubeubajMj™ubjŒ)rÆ}rÇ(jIUjO}rÈ(jQ]jR]jS]jT]jV]ujJj§jD]rÉjy)rÊ}rË(jIX``$pkgid/$compiler``rÌjJjÆjKjLjMj|jO}rÍ(jQ]jR]jS]jT]jV]ujXMjD]rÎj‚)rÏ}rÐ(jIjÌjO}rÑ(jQ]jR]jS]jT]jV]ujJjÊjD]rÒjbX$pkgid/$compilerrÓ…rÔ}rÕ(jIUjJjÏubajMjŠubaubajMj™ubjŒ)rÖ}r×(jIUjO}rØ(jQ]jR]jS]jT]jV]ujJj§jD]rÙjy)rÚ}rÛ(jIX``$pkgid\$compiler``rÜjJjÖjKjLjMj|jO}rÝ(jQ]jR]jS]jT]jV]ujXMjD]rÞj‚)rß}rà(jIX``$pkgid\$compiler``jO}rá(jQ]jR]jS]jT]jV]ujJjÚjD]râjbX$pkgid\$compilerrã…rä}rå(jIUjJjßubajMjŠubaubajMj™ubejMj²ubj‡)ræ}rç(jIUjO}rè(jQ]jR]jS]jT]jV]ujJjƒjD]ré(jŒ)rê}rë(jIUjO}rì(jQ]jR]jS]jT]jV]ujJjæjD]ríjy)rî}rï(jIX:option:`--dynlibdir`rðjJjêjKjLjMj|jO}rñ(jQ]jR]jS]jT]jV]ujXMjD]ròj­)ró}rô(jIjðjJjîjKjLjMj±jO}rõ(UreftypeXoptionj³ˆj´X --dynlibdirU refdomainXstdröjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMjD]r÷j‚)rø}rù(jIjðjO}rú(jQ]jR]rû(j¾jöX std-optionrüejS]jT]jV]ujJjójD]rýjbX --dynlibdirrþ…rÿ}r(jIUjJjøubajMjŠubaubaubajMj™ubjŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjæjD]rjy)r}r(jIX``$libdir/$abi``rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMjD]r j‚)r }r (jIjjO}r (jQ]jR]jS]jT]jV]ujJjjD]r jbX $libdir/$abir…r}r(jIUjJj ubajMjŠubaubajMj™ubjŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjæjD]rjy)r}r(jIX``$libdir\$abi``rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM jD]rj‚)r}r(jIX``$libdir\$abi``jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbX $libdir\$abir…r}r (jIUjJjubajMjŠubaubajMj™ubejMj²ubj‡)r!}r"(jIUjO}r#(jQ]jR]jS]jT]jV]ujJjƒjD]r$(jŒ)r%}r&(jIUjO}r'(jQ]jR]jS]jT]jV]ujJj!jD]r(jy)r)}r*(jIX:option:`--libexecdir`r+jJj%jKjLjMj|jO}r,(jQ]jR]jS]jT]jV]ujXM!jD]r-j­)r.}r/(jIj+jJj)jKjLjMj±jO}r0(UreftypeXoptionj³ˆj´X --libexecdirU refdomainXstdr1jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM!jD]r2j‚)r3}r4(jIj+jO}r5(jQ]jR]r6(j¾j1X std-optionr7ejS]jT]jV]ujJj.jD]r8jbX --libexecdirr9…r:}r;(jIUjJj3ubajMjŠubaubaubajMj™ubjŒ)r<}r=(jIUjO}r>(jQ]jR]jS]jT]jV]ujJj!jD]r?jy)r@}rA(jIX``$prefix/libexec``rBjJj<jKjLjMj|jO}rC(jQ]jR]jS]jT]jV]ujXM"jD]rDj‚)rE}rF(jIjBjO}rG(jQ]jR]jS]jT]jV]ujJj@jD]rHjbX$prefix/libexecrI…rJ}rK(jIUjJjEubajMjŠubaubajMj™ubjŒ)rL}rM(jIUjO}rN(jQ]jR]jS]jT]jV]ujJj!jD]rOjy)rP}rQ(jIX``$prefix\$pkgid``rRjJjLjKjLjMj|jO}rS(jQ]jR]jS]jT]jV]ujXM#jD]rTj‚)rU}rV(jIX``$prefix\$pkgid``jO}rW(jQ]jR]jS]jT]jV]ujJjPjD]rXjbX$prefix\$pkgidrY…rZ}r[(jIUjJjUubajMjŠubaubajMj™ubejMj²ubj‡)r\}r](jIUjO}r^(jQ]jR]jS]jT]jV]ujJjƒjD]r_(jŒ)r`}ra(jIUjO}rb(jQ]jR]jS]jT]jV]ujJj\jD]rcjy)rd}re(jIX :option:`--datadir` (executable)rfjJj`jKjLjMj|jO}rg(jQ]jR]jS]jT]jV]ujXM$jD]rh(j­)ri}rj(jIX:option:`--datadir`rkjJjdjKjLjMj±jO}rl(UreftypeXoptionj³ˆj´X --datadirU refdomainXstdrmjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM$jD]rnj‚)ro}rp(jIjkjO}rq(jQ]jR]rr(j¾jmX std-optionrsejS]jT]jV]ujJjijD]rtjbX --datadirru…rv}rw(jIUjJjoubajMjŠubaubjbX (executable)rx…ry}rz(jIX (executable)jJjdubeubajMj™ubjŒ)r{}r|(jIUjO}r}(jQ]jR]jS]jT]jV]ujJj\jD]r~jy)r}r€(jIX``$prefix/share``rjJj{jKjLjMj|jO}r‚(jQ]jR]jS]jT]jV]ujXM%jD]rƒj‚)r„}r…(jIjjO}r†(jQ]jR]jS]jT]jV]ujJjjD]r‡jbX $prefix/sharerˆ…r‰}rŠ(jIUjJj„ubajMjŠubaubajMj™ubjŒ)r‹}rŒ(jIUjO}r(jQ]jR]jS]jT]jV]ujJj\jD]rŽjy)r}r(jIX ``$prefix``r‘jJj‹jKjLjMj|jO}r’(jQ]jR]jS]jT]jV]ujXM&jD]r“j‚)r”}r•(jIj‘jO}r–(jQ]jR]jS]jT]jV]ujJjjD]r—jbX$prefixr˜…r™}rš(jIUjJj”ubajMjŠubaubajMj™ubejMj²ubj‡)r›}rœ(jIUjO}r(jQ]jR]jS]jT]jV]ujJjƒjD]rž(jŒ)rŸ}r (jIUjO}r¡(jQ]jR]jS]jT]jV]ujJj›jD]r¢jy)r£}r¤(jIX:option:`--datadir` (library)r¥jJjŸjKjLjMj|jO}r¦(jQ]jR]jS]jT]jV]ujXM'jD]r§(j­)r¨}r©(jIX:option:`--datadir`rªjJj£jKjLjMj±jO}r«(UreftypeXoptionj³ˆj´X --datadirU refdomainXstdr¬jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM'jD]r­j‚)r®}r¯(jIjªjO}r°(jQ]jR]r±(j¾j¬X std-optionr²ejS]jT]jV]ujJj¨jD]r³jbX --datadirr´…rµ}r¶(jIUjJj®ubajMjŠubaubjbX (library)r·…r¸}r¹(jIX (library)jJj£ubeubajMj™ubjŒ)rº}r»(jIUjO}r¼(jQ]jR]jS]jT]jV]ujJj›jD]r½jy)r¾}r¿(jIX``$prefix/share``rÀjJjºjKjLjMj|jO}rÁ(jQ]jR]jS]jT]jV]ujXM(jD]rÂj‚)rÃ}rÄ(jIjÀjO}rÅ(jQ]jR]jS]jT]jV]ujJj¾jD]rÆjbX $prefix/sharerÇ…rÈ}rÉ(jIUjJjÃubajMjŠubaubajMj™ubjŒ)rÊ}rË(jIUjO}rÌ(jQ]jR]jS]jT]jV]ujJj›jD]rÍjy)rÎ}rÏ(jIX``%PROGRAMFILES%\Haskell``rÐjJjÊjKjLjMj|jO}rÑ(jQ]jR]jS]jT]jV]ujXM)jD]rÒj‚)rÓ}rÔ(jIX``%PROGRAMFILES%\Haskell``jO}rÕ(jQ]jR]jS]jT]jV]ujJjÎjD]rÖjbX%PROGRAMFILES%\Haskellr×…rØ}rÙ(jIUjJjÓubajMjŠubaubajMj™ubejMj²ubj‡)rÚ}rÛ(jIUjO}rÜ(jQ]jR]jS]jT]jV]ujJjƒjD]rÝ(jŒ)rÞ}rß(jIUjO}rà(jQ]jR]jS]jT]jV]ujJjÚjD]rájy)râ}rã(jIX:option:`--datasubdir`räjJjÞjKjLjMj|jO}rå(jQ]jR]jS]jT]jV]ujXM*jD]ræj­)rç}rè(jIjäjJjâjKjLjMj±jO}ré(UreftypeXoptionj³ˆj´X --datasubdirU refdomainXstdrêjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM*jD]rëj‚)rì}rí(jIjäjO}rî(jQ]jR]rï(j¾jêX std-optionrðejS]jT]jV]ujJjçjD]rñjbX --datasubdirrò…ró}rô(jIUjJjìubajMjŠubaubaubajMj™ubjŒ)rõ}rö(jIUjO}r÷(jQ]jR]jS]jT]jV]ujJjÚjD]røjy)rù}rú(jIX ``$pkgid``rûjJjõjKjLjMj|jO}rü(jQ]jR]jS]jT]jV]ujXM+jD]rýj‚)rþ}rÿ(jIjûjO}r(jQ]jR]jS]jT]jV]ujJjùjD]rjbX$pkgidr…r}r(jIUjJjþubajMjŠubaubajMj™ubjŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjÚjD]rjy)r }r (jIX ``$pkgid``r jJjjKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXM,jD]r j‚)r}r(jIj jO}r(jQ]jR]jS]jT]jV]ujJj jD]rjbX$pkgidr…r}r(jIUjJjubajMjŠubaubajMj™ubejMj²ubj‡)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjƒjD]r(jŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjjD]rjy)r}r(jIX:option:`--docdir`rjJjjKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXM-jD]r!j­)r"}r#(jIjjJjjKjLjMj±jO}r$(UreftypeXoptionj³ˆj´X--docdirU refdomainXstdr%jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM-jD]r&j‚)r'}r((jIjjO}r)(jQ]jR]r*(j¾j%X std-optionr+ejS]jT]jV]ujJj"jD]r,jbX--docdirr-…r.}r/(jIUjJj'ubajMjŠubaubaubajMj™ubjŒ)r0}r1(jIUjO}r2(jQ]jR]jS]jT]jV]ujJjjD]r3jy)r4}r5(jIX``$datadir/doc/$pkgid``r6jJj0jKjLjMj|jO}r7(jQ]jR]jS]jT]jV]ujXM.jD]r8j‚)r9}r:(jIj6jO}r;(jQ]jR]jS]jT]jV]ujJj4jD]r<jbX$datadir/doc/$pkgidr=…r>}r?(jIUjJj9ubajMjŠubaubajMj™ubjŒ)r@}rA(jIUjO}rB(jQ]jR]jS]jT]jV]ujJjjD]rCjy)rD}rE(jIX``$prefix\doc\$pkgid``rFjJj@jKjLjMj|jO}rG(jQ]jR]jS]jT]jV]ujXM/jD]rHj‚)rI}rJ(jIX``$prefix\doc\$pkgid``jO}rK(jQ]jR]jS]jT]jV]ujJjDjD]rLjbX$prefix\doc\$pkgidrM…rN}rO(jIUjJjIubajMjŠubaubajMj™ubejMj²ubj‡)rP}rQ(jIUjO}rR(jQ]jR]jS]jT]jV]ujJjƒjD]rS(jŒ)rT}rU(jIUjO}rV(jQ]jR]jS]jT]jV]ujJjPjD]rWjy)rX}rY(jIX:option:`--sysconfdir`rZjJjTjKjLjMj|jO}r[(jQ]jR]jS]jT]jV]ujXM0jD]r\j­)r]}r^(jIjZjJjXjKjLjMj±jO}r_(UreftypeXoptionj³ˆj´X --sysconfdirU refdomainXstdr`jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM0jD]raj‚)rb}rc(jIjZjO}rd(jQ]jR]re(j¾j`X std-optionrfejS]jT]jV]ujJj]jD]rgjbX --sysconfdirrh…ri}rj(jIUjJjbubajMjŠubaubaubajMj™ubjŒ)rk}rl(jIUjO}rm(jQ]jR]jS]jT]jV]ujJjPjD]rnjy)ro}rp(jIX``$prefix/etc``rqjJjkjKjLjMj|jO}rr(jQ]jR]jS]jT]jV]ujXM1jD]rsj‚)rt}ru(jIjqjO}rv(jQ]jR]jS]jT]jV]ujJjojD]rwjbX $prefix/etcrx…ry}rz(jIUjJjtubajMjŠubaubajMj™ubjŒ)r{}r|(jIUjO}r}(jQ]jR]jS]jT]jV]ujJjPjD]r~jy)r}r€(jIX``$prefix\etc``rjJj{jKjLjMj|jO}r‚(jQ]jR]jS]jT]jV]ujXM2jD]rƒj‚)r„}r…(jIX``$prefix\etc``jO}r†(jQ]jR]jS]jT]jV]ujJjjD]r‡jbX $prefix\etcrˆ…r‰}rŠ(jIUjJj„ubajMjŠubaubajMj™ubejMj²ubj‡)r‹}rŒ(jIUjO}r(jQ]jR]jS]jT]jV]ujJjƒjD]rŽ(jŒ)r}r(jIUjO}r‘(jQ]jR]jS]jT]jV]ujJj‹jD]r’jy)r“}r”(jIX:option:`--htmldir`r•jJjjKjLjMj|jO}r–(jQ]jR]jS]jT]jV]ujXM3jD]r—j­)r˜}r™(jIj•jJj“jKjLjMj±jO}rš(UreftypeXoptionj³ˆj´X --htmldirU refdomainXstdr›jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM3jD]rœj‚)r}rž(jIj•jO}rŸ(jQ]jR]r (j¾j›X std-optionr¡ejS]jT]jV]ujJj˜jD]r¢jbX --htmldirr£…r¤}r¥(jIUjJjubajMjŠubaubaubajMj™ubjŒ)r¦}r§(jIUjO}r¨(jQ]jR]jS]jT]jV]ujJj‹jD]r©jy)rª}r«(jIX``$docdir/html``r¬jJj¦jKjLjMj|jO}r­(jQ]jR]jS]jT]jV]ujXM4jD]r®j‚)r¯}r°(jIj¬jO}r±(jQ]jR]jS]jT]jV]ujJjªjD]r²jbX $docdir/htmlr³…r´}rµ(jIUjJj¯ubajMjŠubaubajMj™ubjŒ)r¶}r·(jIUjO}r¸(jQ]jR]jS]jT]jV]ujJj‹jD]r¹jy)rº}r»(jIX``$docdir\html``r¼jJj¶jKjLjMj|jO}r½(jQ]jR]jS]jT]jV]ujXM5jD]r¾j‚)r¿}rÀ(jIX``$docdir\html``jO}rÁ(jQ]jR]jS]jT]jV]ujJjºjD]rÂjbX $docdir\htmlrÃ…rÄ}rÅ(jIUjJj¿ubajMjŠubaubajMj™ubejMj²ubj‡)rÆ}rÇ(jIUjO}rÈ(jQ]jR]jS]jT]jV]ujJjƒjD]rÉ(jŒ)rÊ}rË(jIUjO}rÌ(jQ]jR]jS]jT]jV]ujJjÆjD]rÍjy)rÎ}rÏ(jIX:option:`--program-prefix`rÐjJjÊjKjLjMj|jO}rÑ(jQ]jR]jS]jT]jV]ujXM6jD]rÒj­)rÓ}rÔ(jIjÐjJjÎjKjLjMj±jO}rÕ(UreftypeXoptionj³ˆj´X--program-prefixU refdomainXstdrÖjT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM6jD]r×j‚)rØ}rÙ(jIjÐjO}rÚ(jQ]jR]rÛ(j¾jÖX std-optionrÜejS]jT]jV]ujJjÓjD]rÝjbX--program-prefixrÞ…rß}rà(jIUjJjØubajMjŠubaubaubajMj™ubjŒ)rá}râ(jIUjO}rã(jQ]jR]jS]jT]jV]ujJjÆjD]räjy)rå}ræ(jIX(empty)rçjJjájKjLjMj|jO}rè(jQ]jR]jS]jT]jV]ujXM7jD]réjbX(empty)rê…rë}rì(jIjçjJjåubaubajMj™ubjŒ)rí}rî(jIUjO}rï(jQ]jR]jS]jT]jV]ujJjÆjD]rðjy)rñ}rò(jIX(empty)rójJjíjKjLjMj|jO}rô(jQ]jR]jS]jT]jV]ujXM8jD]rõjbX(empty)rö…r÷}rø(jIjójJjñubaubajMj™ubejMj²ubj‡)rù}rú(jIUjO}rû(jQ]jR]jS]jT]jV]ujJjƒjD]rü(jŒ)rý}rþ(jIUjO}rÿ(jQ]jR]jS]jT]jV]ujJjùjD]rjy)r}r(jIX:option:`--program-suffix`rjJjýjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM9jD]rj­)r}r(jIjjJjjKjLjMj±jO}r(UreftypeXoptionj³ˆj´X--program-suffixU refdomainXstdr jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM9jD]r j‚)r }r (jIjjO}r (jQ]jR]r(j¾j X std-optionrejS]jT]jV]ujJjjD]rjbX--program-suffixr…r}r(jIUjJj ubajMjŠubaubaubajMj™ubjŒ)r}r(jIUjO}r(jQ]jR]jS]jT]jV]ujJjùjD]rjy)r}r(jIX(empty)rjJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM:jD]rjbX(empty)r…r}r(jIjjJjubaubajMj™ubjŒ)r }r!(jIUjO}r"(jQ]jR]jS]jT]jV]ujJjùjD]r#jy)r$}r%(jIX(empty)r&jJj jKjLjMj|jO}r'(jQ]jR]jS]jT]jV]ujXM;jD]r(jbX(empty)r)…r*}r+(jIj&jJj$ubaubajMj™ubejMj²ubejMUtbodyr,ubejMUtgroupr-ubeubeubjF)r.}r/(jIUjJjõ jKjLjMjNjO}r0(jQ]jR]jS]jT]r1hâajV]r2h;aujXM>jYhjD]r3(j[)r4}r5(jIXPrefix-independencer6jJj.jKjLjMj_jO}r7(jQ]jR]jS]jT]jV]ujXM>jYhjD]r8jbXPrefix-independencer9…r:}r;(jIj6jKNjXNjYhjJj4ubaubjy)r<}r=(jIXOn 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.jJj.jKjLjMj|jO}r>(jQ]jR]jS]jT]jV]ujXM@jYhjD]r?(jbX>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 r@…rA}rB(jIX>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 jKNjXNjYhjJj<ubj‚)rC}rD(jIX ``$bindir``jO}rE(jQ]jR]jS]jT]jV]ujJj<jD]rFjbX$bindirrG…rH}rI(jIUjJjCubajMjŠubjbXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of rJ…rK}rL(jIXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of jKNjXNjYhjJj<ubj‚)rM}rN(jIX ``$prefix``jO}rO(jQ]jR]jS]jT]jV]ujJj<jD]rPjbX$prefixrQ…rR}rS(jIUjJjMubajMjŠubjbXX) at install-time, rather than having to bake the path into the binary when it is built.rT…rU}rV(jIXX) at install-time, rather than having to bake the path into the binary when it is built.jKNjXNjYhjJj<ubeubjy)rW}rX(jIX 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.jJj.jKjLjMj|jO}rY(jQ]jR]jS]jT]jV]ujXMIjYhjD]rZ(jbXOIn order to achieve this, we require that for an executable on Windows, all of r[…r\}r](jIXOIn order to achieve this, we require that for an executable on Windows, all of jKNjXNjYhjJjWubj‚)r^}r_(jIX ``$bindir``jO}r`(jQ]jR]jS]jT]jV]ujJjWjD]rajbX$bindirrb…rc}rd(jIUjJj^ubajMjŠubjbX, re…rf}rg(jIX, rhjKNjXNjYhjJjWubj‚)ri}rj(jIX ``$libdir``jO}rk(jQ]jR]jS]jT]jV]ujJjWjD]rljbX$libdirrm…rn}ro(jIUjJjiubajMjŠubjbX, rp…rq}rr(jIX, jJjWubj‚)rs}rt(jIX``$dynlibdir``jO}ru(jQ]jR]jS]jT]jV]ujJjWjD]rvjbX $dynlibdirrw…rx}ry(jIUjJjsubajMjŠubjbX, rz…r{}r|(jIjhjJjWubj‚)r}}r~(jIX ``$datadir``jO}r(jQ]jR]jS]jT]jV]ujJjWjD]r€jbX$datadirr…r‚}rƒ(jIUjJj}ubajMjŠubjbX and r„…r…}r†(jIX and jKNjXNjYhjJjWubj‚)r‡}rˆ(jIX``$libexecdir``jO}r‰(jQ]jR]jS]jT]jV]ujJjWjD]rŠjbX $libexecdirr‹…rŒ}r(jIUjJj‡ubajMjŠubjbX begin with rŽ…r}r(jIX begin with jKNjXNjYhjJjWubj‚)r‘}r’(jIX ``$prefix``jO}r“(jQ]jR]jS]jT]jV]ujJjWjD]r”jbX$prefixr•…r–}r—(jIUjJj‘ubajMjŠubjbX]. If this is not the case then the compiled executable will have baked-in all absolute paths.r˜…r™}rš(jIX]. If this is not the case then the compiled executable will have baked-in all absolute paths.jKNjXNjYhjJjWubeubjy)r›}rœ(jIX>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.jJj.jKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMNjYhjD]rž(jbXdThe application need do nothing special to achieve prefix-independence. If it finds any files using rŸ…r }r¡(jIXdThe application need do nothing special to achieve prefix-independence. If it finds any files using jKNjXNjYhjJj›ubj‚)r¢}r£(jIX``getDataFileName``jO}r¤(jQ]jR]jS]jT]jV]ujJj›jD]r¥jbXgetDataFileNamer¦…r§}r¨(jIUjJj¢ubajMjŠubjbX and the r©…rª}r«(jIX and the jKNjXNjYhjJj›ubjœ)r¬}r­(jIXn`other functions provided for the purpose `__jO}r®(UnameX(other functions provided for the purposejêX?developing-packages.html#accessing-data-files-from-package-codejT]jS]jQ]jR]jV]ujJj›jD]r¯jbX(other functions provided for the purposer°…r±}r²(jIUjJj¬ubajMj¥ubjbXP, the files will be accessed relative to the location of the current executable.r³…r´}rµ(jIXP, the files will be accessed relative to the location of the current executable.jKNjXNjYhjJj›ubeubjy)r¶}r·(jIX¥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¸jJj.jKjLjMj|jO}r¹(jQ]jR]jS]jT]jV]ujXMUjYhjD]rºjbX¥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½(jIj¸jKNjXNjYhjJj¶ubaubeubeubjF)r¾}r¿(jIUjJjdjKjLjMjNjO}rÀ(jQ]jR]jS]jT]rÁj8ajV]rÂh˜aujXMZjYhjD]rÃ(j[)rÄ}rÅ(jIXControlling Flag AssignmentsrÆjJj¾jKjLjMj_jO}rÇ(jQ]jR]jS]jT]jV]ujXMZjYhjD]rÈjbXControlling Flag AssignmentsrÉ…rÊ}rË(jIjÆjKNjXNjYhjJjÄubaubjy)rÌ}rÍ(jIXºFlag assignments (see the `resolution of conditions and flags `__) can be controlled with the following command line options.jJj¾jKjLjMj|jO}rÎ(jQ]jR]jS]jT]jV]ujXM\jYhjD]rÏ(jbXFlag assignments (see the rÐ…rÑ}rÒ(jIXFlag assignments (see the jKNjXNjYhjJjÌubjœ)rÓ}rÔ(jIXd`resolution of conditions and flags `__jO}rÕ(UnameX"resolution of conditions and flagsjêX;developing-packages.html#resolution-of-conditions-and-flagsjT]jS]jQ]jR]jV]ujJjÌjD]rÖjbX"resolution of conditions and flagsr×…rØ}rÙ(jIUjJjÓubajMj¥ubjbX<) can be controlled with the following command line options.rÚ…rÛ}rÜ(jIX<) can be controlled with the following command line options.jKNjXNjYhjJjÌubeubj’)rÝ}rÞ(jIUjJj¾jKjLjMj•jO}rß(jT]jS]jQ]jR]jV]Uentries]rà(j˜X@setup-configure command line option; -f flagname or -f -flagnamejBUNtráaujXNjYhjD]ubjš)râ}rã(jIUjJj¾jKjLjMjjO}rä(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionråj£jåujXNjYhjD]ræ(j¥)rç}rè(jIX-f flagname or -f -flagnamejJjâjKjLjMj¨jO}ré(jª]rêX-frëajT]rìjBajS]jQ]jR]jV]ríh¢aj°‰ujXMfjYhjD]rî(j²)rï}rð(jIjëjJjçjKjLjMjµjO}rñ(j½j¾jT]jS]jQ]jR]jV]ujXMfjYhjD]ròjbX-fró…rô}rõ(jIUjKNjXNjYhjJjïubaubj»)rö}r÷(jIX flagname or -f -flagnamejJjçjKjLjMj¾jO}rø(j½j¾jT]jS]jQ]jR]jV]ujXMfjYhjD]rùjbX flagname or -f -flagnamerú…rû}rü(jIUjKNjXNjYhjJjöubaubeubjÖ)rý}rþ(jIUjJjâjKjLjMjÙjO}rÿ(jQ]jR]jS]jT]jV]ujXMfjYhjD]rjy)r}r(jIXÐ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``jJjýjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXMbjYhjD]r(jbXForce the specified flag to r…r}r(jIXForce the specified flag to jKNjXNjYhjJjubj‚)r}r (jIX``true``jO}r (jQ]jR]jS]jT]jV]ujJjjD]r jbXtruer …r }r(jIUjJjubajMjŠubjbX or r…r}r(jIX or jKNjXNjYhjJjubj‚)r}r(jIX ``false``jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXfalser…r}r(jIUjJjubajMjŠubjbX (if preceded with a r…r}r(jIX (if preceded with a jKNjXNjYhjJjubj‚)r}r(jIX``-``jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbX-…r }r!(jIUjJjubajMjŠubjbXS). Later specifications for the same flags will override earlier, i.e., specifying r"…r#}r$(jIXS). Later specifications for the same flags will override earlier, i.e., specifying jKNjXNjYhjJjubj‚)r%}r&(jIX``-fdebug -f-debug``jO}r'(jQ]jR]jS]jT]jV]ujJjjD]r(jbX-fdebug -f-debugr)…r*}r+(jIUjJj%ubajMjŠubjbX is equivalent to r,…r-}r.(jIX is equivalent to jKNjXNjYhjJjubj‚)r/}r0(jIX ``-f-debug``jO}r1(jQ]jR]jS]jT]jV]ujJjjD]r2jbX-f-debugr3…r4}r5(jIUjJj/ubajMjŠubeubaubeubj’)r6}r7(jIUjJj¾jKjLjMj•jO}r8(jT]jS]jQ]jR]jV]Uentries]r9(j˜X6setup-configure command line option; --flags=flagspecsjUNtr:aujXNjYhjD]ubjš)r;}r<(jIUjJj¾jKjLjMjjO}r=(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr>j£j>ujXNjYhjD]r?(j¥)r@}rA(jIX--flags=flagspecsjJj;jKjLjMj¨jO}rB(jª]rCX--flagsrDajT]rEjajS]jQ]jR]jV]rFhsaj°‰ujXMojYhjD]rG(j²)rH}rI(jIjDjJj@jKjLjMjµjO}rJ(j½j¾jT]jS]jQ]jR]jV]ujXMojYhjD]rKjbX--flagsrL…rM}rN(jIUjKNjXNjYhjJjHubaubj»)rO}rP(jIX =flagspecsjJj@jKjLjMj¾jO}rQ(j½j¾jT]jS]jQ]jR]jV]ujXMojYhjD]rRjbX =flagspecsrS…rT}rU(jIUjKNjXNjYhjJjOubaubeubjÖ)rV}rW(jIUjJj;jKjLjMjÙjO}rX(jQ]jR]jS]jT]jV]ujXMojYhjD]rYjy)rZ}r[(jIXESame 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``.jJjVjKjLjMj|jO}r\(jQ]jR]jS]jT]jV]ujXMijYhjD]r](jbXSame as r^…r_}r`(jIXSame as jKNjXNjYhjJjZubj‚)ra}rb(jIX``-f``jO}rc(jQ]jR]jS]jT]jV]ujJjZjD]rdjbX-fre…rf}rg(jIUjJjaubajMjŠubjbX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to rh…ri}rj(jIX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to jKNjXNjYhjJjZubj‚)rk}rl(jIX``true``jO}rm(jQ]jR]jS]jT]jV]ujJjZjD]rnjbXtruero…rp}rq(jIUjJjkubajMjŠubjbX), optionally preceded by a rr…rs}rt(jIX), optionally preceded by a jKNjXNjYhjJjZubj‚)ru}rv(jIX``-``jO}rw(jQ]jR]jS]jT]jV]ujJjZjD]rxjbX-…ry}rz(jIUjJjuubajMjŠubjbX (to force a flag to r{…r|}r}(jIX (to force a flag to jKNjXNjYhjJjZubj‚)r~}r(jIX ``false``jO}r€(jQ]jR]jS]jT]jV]ujJjZjD]rjbXfalser‚…rƒ}r„(jIUjJj~ubajMjŠubjbX). For example, r……r†}r‡(jIX). For example, jKNjXNjYhjJjZubj‚)rˆ}r‰(jIX&``--flags="debug -feature1 feature2"``jO}rŠ(jQ]jR]jS]jT]jV]ujJjZjD]r‹jbX"--flags="debug -feature1 feature2"rŒ…r}rŽ(jIUjJjˆubajMjŠubjbX is equivalent to r…r}r‘(jIX is equivalent to jKNjXNjYhjJjZubj‚)r’}r“(jIX"``-fdebug -f-feature1 -ffeature2``jO}r”(jQ]jR]jS]jT]jV]ujJjZjD]r•jbX-fdebug -f-feature1 -ffeature2r–…r—}r˜(jIUjJj’ubajMjŠubjbX.…r™}rš(jIX.jKNjXNjYhjJjZubeubaubeubeubjF)r›}rœ(jIUjJjdjKjLjMjNjO}r(jQ]jR]jS]jT]ržhÉajV]rŸh"aujXMqjYhjD]r (j[)r¡}r¢(jIXBuilding Test Suitesr£jJj›jKjLjMj_jO}r¤(jQ]jR]jS]jT]jV]ujXMqjYhjD]r¥jbXBuilding Test Suitesr¦…r§}r¨(jIj£jKNjXNjYhjJj¡ubaubj’)r©}rª(jIUjJj›jKjLjMj•jO}r«(jT]jS]jQ]jR]jV]Uentries]r¬(j˜X3setup-configure command line option; --enable-testsj9UNtr­aujXNjYhjD]ubjš)r®}r¯(jIUjJj›jKjLjMjjO}r°(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr±j£j±ujXNjYhjD]r²(j¥)r³}r´(jIX--enable-testsrµjJj®jKjLjMj¨jO}r¶(jª]r·jµajT]r¸j9ajS]jQ]jR]jV]r¹h™aj°‰ujXMzjYhjD]rº(j²)r»}r¼(jIjµjJj³jKjLjMjµjO}r½(j½j¾jT]jS]jQ]jR]jV]ujXMzjYhjD]r¾jbX--enable-testsr¿…rÀ}rÁ(jIUjKNjXNjYhjJj»ubaubj»)rÂ}rÃ(jIUjJj³jKjLjMj¾jO}rÄ(j½j¾jT]jS]jQ]jR]jV]ujXMzjYhjD]ubeubjÖ)rÅ}rÆ(jIUjJj®jKjLjMjÙjO}rÇ(jQ]jR]jS]jT]jV]ujXMzjYhjD]rÈjy)rÉ}rÊ(jIXBuild 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.jJjÅjKjLjMj|jO}rË(jQ]jR]jS]jT]jV]ujXMujYhjD]rÌ(jbXIBuild the test suites defined in the package description file during the rÍ…rÎ}rÏ(jIXIBuild the test suites defined in the package description file during the jKNjXNjYhjJjÉubj‚)rÐ}rÑ(jIX ``build``jO}rÒ(jQ]jR]jS]jT]jV]ujJjÉjD]rÓjbXbuildrÔ…rÕ}rÖ(jIUjJjÐubajMjŠubjbXŸ 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Ù(jIXŸ 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 jKNjXNjYhjJjÉubj‚)rÚ}rÛ(jIX``test``jO}rÜ(jQ]jR]jS]jT]jV]ujJjÉjD]rÝjbXtestrÞ…rß}rà(jIUjJjÚubajMjŠubjbX$ command after the package is built.rá…râ}rã(jIX$ command after the package is built.jKNjXNjYhjJjÉubeubaubeubj’)rä}rå(jIUjJj›jKjLjMj•jO}ræ(jT]jS]jQ]jR]jV]Uentries]rç(j˜X4setup-configure command line option; --disable-testsj:UNtrèaujXNjYhjD]ubjš)ré}rê(jIUjJj›jKjLjMjjO}rë(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrìj£jìujXNjYhjD]rí(j¥)rî}rï(jIX--disable-testsrðjJjéjKjLjMj¨jO}rñ(jª]ròjðajT]rój:ajS]jQ]jR]jV]rôhšaj°‰ujXMjYhjD]rõ(j²)rö}r÷(jIjðjJjîjKjLjMjµjO}rø(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rùjbX--disable-testsrú…rû}rü(jIUjKNjXNjYhjJjöubaubj»)rý}rþ(jIUjJjîjKjLjMj¾jO}rÿ(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubeubjÖ)r}r(jIUjJjéjKjLjMjÙjO}r(jQ]jR]jS]jT]jV]ujXMjYhjD]rjy)r}r(jIXÜ(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.jJjjKjLjMj|jO}r(jQ]jR]jS]jT]jV]ujXM}jYhjD]r(jbX2(default) Do not build any test suites during the r…r }r (jIX2(default) Do not build any test suites during the jKNjXNjYhjJjubj‚)r }r (jIX ``build``jO}r (jQ]jR]jS]jT]jV]ujJjjD]rjbXbuildr…r}r(jIUjJj ubajMjŠubjbXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the r…r}r(jIXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the jKNjXNjYhjJjubj‚)r}r(jIX``test``jO}r(jQ]jR]jS]jT]jV]ujJjjD]rjbXtestr…r}r(jIUjJjubajMjŠubjbX+ command without reconfiguring the package.r…r}r(jIX+ command without reconfiguring the package.jKNjXNjYhjJjubeubaubeubj’)r}r (jIUjJj›jKjLjMj•jO}r!(jT]jS]jQ]jR]jV]Uentries]r"(j˜X6setup-configure command line option; --enable-coveragehýUNtr#aujXNjYhjD]ubjš)r$}r%(jIUjJj›jKjLjMjjO}r&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr'j£j'ujXNjYhjD]r((j¥)r)}r*(jIX--enable-coverager+jJj$jKjLjMj¨jO}r,(jª]r-j+ajT]r.hýajS]jQ]jR]jV]r/hWaj°‰ujXM‡jYhjD]r0(j²)r1}r2(jIj+jJj)jKjLjMjµjO}r3(j½j¾jT]jS]jQ]jR]jV]ujXM‡jYhjD]r4jbX--enable-coverager5…r6}r7(jIUjKNjXNjYhjJj1ubaubj»)r8}r9(jIUjJj)jKjLjMj¾jO}r:(j½j¾jT]jS]jQ]jR]jV]ujXM‡jYhjD]ubeubjÖ)r;}r<(jIUjJj$jKjLjMjÙjO}r=(jQ]jR]jS]jT]jV]ujXM‡jYhjD]r>jy)r?}r@(jIX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.rAjJj;jKjLjMj|jO}rB(jQ]jR]jS]jT]jV]ujXM„jYhjD]rCjbX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.rD…rE}rF(jIjAjKNjXNjYhjJj?ubaubaubeubj’)rG}rH(jIUjJj›jKjLjMj•jO}rI(jT]jS]jQ]jR]jV]Uentries]rJ(j˜X7setup-configure command line option; --disable-coveragejUNtrKaujXNjYhjD]ubjš)rL}rM(jIUjJj›jKjLjMjjO}rN(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrOj£jOujXNjYhjD]rP(j¥)rQ}rR(jIX--disable-coveragerSjJjLjKjLjMj¨jO}rT(jª]rUjSajT]rVjajS]jQ]jR]jV]rWh{aj°‰ujXM‹jYhjD]rX(j²)rY}rZ(jIjSjJjQjKjLjMjµjO}r[(j½j¾jT]jS]jQ]jR]jV]ujXM‹jYhjD]r\jbX--disable-coverager]…r^}r_(jIUjKNjXNjYhjJjYubaubj»)r`}ra(jIUjJjQjKjLjMj¾jO}rb(j½j¾jT]jS]jQ]jR]jV]ujXM‹jYhjD]ubeubjÖ)rc}rd(jIUjJjLjKjLjMjÙjO}re(jQ]jR]jS]jT]jV]ujXM‹jYhjD]rfjy)rg}rh(jIX1(default) Do not enable Haskell Program Coverage.rijJjcjKjLjMj|jO}rj(jQ]jR]jS]jT]jV]ujXMŠjYhjD]rkjbX1(default) Do not enable Haskell Program Coverage.rl…rm}rn(jIjijKNjXNjYhjJjgubaubaubeubeubjF)ro}rp(jIUjJjdjKjLjMjNjO}rq(jQ]jR]jS]jT]rrhÃajV]rshaujXMjYhjD]rt(j[)ru}rv(jIXMiscellaneous optionsrwjJjojKjLjMj_jO}rx(jQ]jR]jS]jT]jV]ujXMjYhjD]ryjbXMiscellaneous optionsrz…r{}r|(jIjwjKNjXNjYhjJjuubaubj’)r}}r~(jIUjJjojKjLjMj•jO}r(jT]jS]jQ]jR]jV]Uentries]r€(j˜X+setup-configure command line option; --userhõUNtraujXNjYhjD]ubjš)r‚}rƒ(jIUjJjojKjLjMjjO}r„(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr…j£j…ujXNjYhjD]r†(j¥)r‡}rˆ(jIX--userr‰jJj‚jKjLjMj¨jO}rŠ(jª]r‹j‰ajT]rŒhõajS]jQ]jR]jV]rhOaj°‰ujXM˜jYhjD]rŽ(j²)r}r(jIj‰jJj‡jKjLjMjµjO}r‘(j½j¾jT]jS]jQ]jR]jV]ujXM˜jYhjD]r’jbX--userr“…r”}r•(jIUjKNjXNjYhjJjubaubj»)r–}r—(jIUjJj‡jKjLjMj¾jO}r˜(j½j¾jT]jS]jQ]jR]jV]ujXM˜jYhjD]ubeubjÖ)r™}rš(jIUjJj‚jKjLjMjÙjO}r›(jQ]jR]jS]jT]jV]ujXM˜jYhjD]rœjy)r}rž(jIX¡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.jJj™jKjLjMj|jO}rŸ(jQ]jR]jS]jT]jV]ujXM‘jYhjD]r (jbX/Does a per-user installation. This changes the r¡…r¢}r£(jIX/Does a per-user installation. This changes the jKNjXNjYhjJjubjœ)r¤}r¥(jIXC`default installation prefix <#paths-in-the-simple-build-system>`__jO}r¦(UnameXdefault installation prefixjêX!#paths-in-the-simple-build-systemjT]jS]jQ]jR]jV]ujJjjD]r§jbXdefault installation prefixr¨…r©}rª(jIUjJj¤ubajMj¥ubjbX’. 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­(jIX. 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 jKNjXNjYhjJjubj‚)r®}r¯(jIX ``--user``jO}r°(jQ]jR]jS]jT]jV]ujJjjD]r±jbX--userr²…r³}r´(jIUjJj®ubajMjŠubjbX for any subsequent rµ…r¶}r·(jIX for any subsequent jKNjXNjYhjJjubj‚)r¸}r¹(jIX ``install``jO}rº(jQ]jR]jS]jT]jV]ujJjjD]r»jbXinstallr¼…r½}r¾(jIUjJj¸ubajMjŠubjbXx command, as packages registered in the global database should not depend on packages registered in a user’s database.r¿…rÀ}rÁ(jIXv command, as packages registered in the global database should not depend on packages registered in a user's database.jKNjXNjYhjJjubeubaubeubj’)rÂ}rÃ(jIUjJjojKjLjMj•jO}rÄ(jT]jS]jQ]jR]jV]Uentries]rÅ(j˜X-setup-configure command line option; --globalh¹UNtrÆaujXNjYhjD]ubjš)rÇ}rÈ(jIUjJjojKjLjMjjO}rÉ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÊj£jÊujXNjYhjD]rË(j¥)rÌ}rÍ(jIX--globalrÎjJjÇjKjLjMj¨jO}rÏ(jª]rÐjÎajT]rÑh¹ajS]jQ]jR]jV]rÒhaj°‰ujXMŸjYhjD]rÓ(j²)rÔ}rÕ(jIjÎjJjÌjKjLjMjµjO}rÖ(j½j¾jT]jS]jQ]jR]jV]ujXMŸjYhjD]r×jbX--globalrØ…rÙ}rÚ(jIUjKNjXNjYhjJjÔubaubj»)rÛ}rÜ(jIUjJjÌjKjLjMj¾jO}rÝ(j½j¾jT]jS]jQ]jR]jV]ujXMŸjYhjD]ubeubjÖ)rÞ}rß(jIUjJjÇjKjLjMjÙjO}rà(jQ]jR]jS]jT]jV]ujXMŸjYhjD]rájy)râ}rã(jIX(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äjJjÞjKjLjMj|jO}rå(jQ]jR]jS]jT]jV]ujXM›jYhjD]ræjbX(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é(jIjäjKNjXNjYhjJjâubaubaubeubj’)rê}rë(jIUjJjojKjLjMj•jO}rì(jT]jS]jQ]jR]jV]Uentries]rí(j˜X4setup-configure command line option; --package-db=dbj UNtrîaujXNjYhjD]ubjš)rï}rð(jIUjJjojKjLjMjjO}rñ(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionròj£jòujXNjYhjD]ró(j¥)rô}rõ(jIX--package-db=dbjJjïjKjLjMj¨jO}rö(jª]r÷X --package-dbrøajT]rùj ajS]jQ]jR]jV]rúhcaj°‰ujXM±jYhjD]rû(j²)rü}rý(jIjøjJjôjKjLjMjµjO}rþ(j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]rÿjbX --package-dbr …r }r (jIUjKNjXNjYhjJjüubaubj»)r }r (jIX=dbjJjôjKjLjMj¾jO}r (j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]r jbX=dbr …r }r (jIUjKNjXNjYhjJj ubaubeubjÖ)r }r (jIUjJjïjKjLjMjÙjO}r (jQ]jR]jS]jT]jV]ujXM±jYhjD]r (jy)r }r (jIX]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.jJj jKjLjMj|jO}r (jQ]jR]jS]jT]jV]ujXM¢jYhjD]r (jbXRAllows package dependencies to be satisfied from this additional package database r …r }r (jIXRAllows package dependencies to be satisfied from this additional package database jKNjXNjYhjJj ubj½)r }r (jIX*db*jO}r (jQ]jR]jS]jT]jV]ujJj jD]r jbXdbr …r }r (jIUjJj ubajMjÅubjbX‚ in addition to the global package database. All packages in the user’s package database will be ignored. The interpretation of r …r }r (jIX€ in addition to the global package database. All packages in the user's package database will be ignored. The interpretation of jKNjXNjYhjJj ubj½)r }r (jIX*db*jO}r! (jQ]jR]jS]jT]jV]ujJj jD]r" jbXdbr# …r$ }r% (jIUjJj ubajMjÅubjbXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.r& …r' }r( (jIXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.jKNjXNjYhjJj ubeubjy)r) }r* (jIXbThis 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.jJj jKjLjMj|jO}r+ (jQ]jR]jS]jT]jV]ujXM©jYhjD]r, (jbX/This pushes an extra db onto the db stack. The r- …r. }r/ (jIX/This pushes an extra db onto the db stack. The jKNjXNjYhjJj) ubj­)r0 }r1 (jIX:option:`--global`r2 jJj) jKjLjMj±jO}r3 (UreftypeXoptionj³ˆj´X--globalU refdomainXstdr4 jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM©jD]r5 j‚)r6 }r7 (jIj2 jO}r8 (jQ]jR]r9 (j¾j4 X std-optionr: ejS]jT]jV]ujJj0 jD]r; jbX--globalr< …r= }r> (jIUjJj6 ubajMjŠubaubjbX and r? …r@ }rA (jIX and jKNjXNjYhjJj) ubj­)rB }rC (jIX:option:`--user`rD jJj) jKjLjMj±jO}rE (UreftypeXoptionj³ˆj´X--userU refdomainXstdrF jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM©jD]rG j‚)rH }rI (jIjD jO}rJ (jQ]jR]rK (j¾jF X std-optionrL ejS]jT]jV]ujJjB jD]rM jbX--userrN …rO }rP (jIUjJjH ubajMjŠubaubjbX  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.rQ …rR }rS (jIX  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.jKNjXNjYhjJj) ubeubjy)rT }rU (jIX/To reset the stack, use ``--package-db=clear``.jJj jKjLjMj|jO}rV (jQ]jR]jS]jT]jV]ujXM°jYhjD]rW (jbXTo reset the stack, use rX …rY }rZ (jIXTo reset the stack, use jKNjXNjYhjJjT ubj‚)r[ }r\ (jIX``--package-db=clear``jO}r] (jQ]jR]jS]jT]jV]ujJjT jD]r^ jbX--package-db=clearr_ …r` }ra (jIUjJj[ ubajMjŠubjbX.…rb }rc (jIX.jKNjXNjYhjJjT ubeubeubeubj’)rd }re (jIUjJjojKjLjMj•jO}rf (jT]jS]jQ]jR]jV]Uentries]rg (j˜X0setup-configure command line option; --ipid=ipidjUNtrh aujXNjYhjD]ubjš)ri }rj (jIUjJjojKjLjMjjO}rk (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrl j£jl ujXNjYhjD]rm (j¥)rn }ro (jIX --ipid=ipidjJji jKjLjMj¨jO}rp (jª]rq X--ipidrr ajT]rs jajS]jQ]jR]jV]rt hbaj°‰ujXM»jYhjD]ru (j²)rv }rw (jIjr jJjn jKjLjMjµjO}rx (j½j¾jT]jS]jQ]jR]jV]ujXM»jYhjD]ry jbX--ipidrz …r{ }r| (jIUjKNjXNjYhjJjv ubaubj»)r} }r~ (jIX=ipidjJjn jKjLjMj¾jO}r (j½j¾jT]jS]jQ]jR]jV]ujXM»jYhjD]r€ jbX=ipidr …r‚ }rƒ (jIUjKNjXNjYhjJj} ubaubeubjÖ)r„ }r… (jIUjJji jKjLjMjÙjO}r† (jQ]jR]jS]jT]jV]ujXM»jYhjD]r‡ jy)rˆ }r‰ (jIX¢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``.jJj„ jKjLjMj|jO}rŠ (jQ]jR]jS]jT]jV]ujXM´jYhjD]r‹ (jbXSpecifies the rŒ …r }rŽ (jIXSpecifies the jKNjXNjYhjJjˆ ubj½)r }r (jIX*installed package identifier*jO}r‘ (jQ]jR]jS]jT]jV]ujJjˆ jD]r’ jbXinstalled package identifierr“ …r” }r• (jIUjJj ubajMjÅubjbXt 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˜ (jIXt of the package to be built; this identifier is passed on to GHC and serves as the basis for linker symbols and the jKNjXNjYhjJjˆ ubj‚)r™ }rš (jIX``id``jO}r› (jQ]jR]jS]jT]jV]ujJjˆ jD]rœ jbXidr …rž }rŸ (jIUjJj™ ubajMjŠubjbX field in a r  …r¡ }r¢ (jIX field in a jKNjXNjYhjJjˆ ubj‚)r£ }r¤ (jIX ``ghc-pkg``jO}r¥ (jQ]jR]jS]jT]jV]ujJjˆ jD]r¦ jbXghc-pkgr§ …r¨ }r© (jIUjJj£ ubajMjŠubjbX– 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¬ (jIX– registration. When a package has multiple components, the actual component identifiers are derived off of this identifier (e.g., an internal library jKNjXNjYhjJjˆ ubj‚)r­ }r® (jIX``foo``jO}r¯ (jQ]jR]jS]jT]jV]ujJjˆ jD]r° jbXfoor± …r² }r³ (jIUjJj­ ubajMjŠubjbX from package r´ …rµ }r¶ (jIX from package jKNjXNjYhjJjˆ ubj‚)r· }r¸ (jIX``p-0.1-abcd``jO}r¹ (jQ]jR]jS]jT]jV]ujJjˆ jD]rº jbX p-0.1-abcdr» …r¼ }r½ (jIUjJj· ubajMjŠubjbX will get the identifier r¾ …r¿ }rÀ (jIX will get the identifier jKNjXNjYhjJjˆ ubj‚)rÁ }r (jIX``p-0.1-abcd-foo``jO}rà (jQ]jR]jS]jT]jV]ujJjˆ jD]rÄ jbXp-0.1-abcd-foorÅ …rÆ }rÇ (jIUjJjÁ ubajMjŠubjbX.…rÈ }rÉ (jIX.jKNjXNjYhjJjˆ ubeubaubeubj’)rÊ }rË (jIUjJjojKjLjMj•jO}rÌ (jT]jS]jQ]jR]jV]Uentries]rÍ (j˜X.setup-configure command line option; --cid=cidh­UNtrÎ aujXNjYhjD]ubjš)rÏ }rÐ (jIUjJjojKjLjMjjO}rÑ (jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÒ j£jÒ ujXNjYhjD]rÓ (j¥)rÔ }rÕ (jIX --cid=cidjJjÏ jKjLjMj¨jO}rÖ (jª]r× X--cidrØ ajT]rÙ h­ajS]jQ]jR]jV]rÚ haj°‰ujXMÀjYhjD]rÛ (j²)rÜ }rÝ (jIjØ jJjÔ jKjLjMjµjO}rÞ (j½j¾jT]jS]jQ]jR]jV]ujXMÀjYhjD]rß jbX--cidrà …rá }râ (jIUjKNjXNjYhjJjÜ ubaubj»)rã }rä (jIX=cidjJjÔ jKjLjMj¾jO}rå (j½j¾jT]jS]jQ]jR]jV]ujXMÀjYhjD]ræ jbX=cidrç …rè }ré (jIUjKNjXNjYhjJjã ubaubeubjÖ)rê }rë (jIUjJjÏ jKjLjMjÙjO}rì (jQ]jR]jS]jT]jV]ujXMÀjYhjD]rí jy)rî }rï (jIX€Specifies the *component identifier* of the component being built; this is only valid if you are configuring a single component.jJjê jKjLjMj|jO}rð (jQ]jR]jS]jT]jV]ujXM¾jYhjD]rñ (jbXSpecifies the rò …ró }rô (jIXSpecifies the jKNjXNjYhjJjî ubj½)rõ }rö (jIX*component identifier*jO}r÷ (jQ]jR]jS]jT]jV]ujJjî jD]rø jbXcomponent identifierrù …rú }rû (jIUjJjõ ubajMjÅubjbX\ of the component being built; this is only valid if you are configuring a single component.rü …rý }rþ (jIX\ of the component being built; this is only valid if you are configuring a single component.jKNjXNjYhjJjî ubeubaubeubj’)rÿ }r!(jIUjJjojKjLjMj•jO}r!(jT]jS]jQ]jR]jV]Uentries]r!(j˜X?setup-configure command line option; --default-user-config=filehÒUNtr!aujXNjYhjD]ubjš)r!}r!(jIUjJjojKjLjMjjO}r!(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr!j£j!ujXNjYhjD]r!(j¥)r !}r !(jIX--default-user-config=filejJj!jKjLjMj¨jO}r !(jª]r !X--default-user-configr !ajT]r!hÒajS]jQ]jR]jV]r!h+aj°‰ujXMÉjYhjD]r!(j²)r!}r!(jIj !jJj !jKjLjMjµjO}r!(j½j¾jT]jS]jQ]jR]jV]ujXMÉjYhjD]r!jbX--default-user-configr!…r!}r!(jIUjKNjXNjYhjJj!ubaubj»)r!}r!(jIX=filejJj !jKjLjMj¾jO}r!(j½j¾jT]jS]jQ]jR]jV]ujXMÉjYhjD]r!jbX=filer!…r!}r!(jIUjKNjXNjYhjJj!ubaubeubjÖ)r!}r !(jIUjJj!jKjLjMjÙjO}r!!(jQ]jR]jS]jT]jV]ujXMÉjYhjD]r"!jy)r#!}r$!(jIXwAllows 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.jJj!jKjLjMj|jO}r%!(jQ]jR]jS]jT]jV]ujXMÃjYhjD]r&!(jbXAllows a “default†r'!…r(!}r)!(jIXAllows a "default" jKNjXNjYhjJj#!ubj‚)r*!}r+!(jIX``cabal.config``jO}r,!(jQ]jR]jS]jT]jV]ujJj#!jD]r-!jbX cabal.configr.!…r/!}r0!(jIUjJj*!ubajMjŠubjbX¬ 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 r1!…r2!}r3!(jIX¬ 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 jKNjXNjYhjJj#!ubj‚)r4!}r5!(jIX ``config``jO}r6!(jQ]jR]jS]jT]jV]ujJj#!jD]r7!jbXconfigr8!…r9!}r:!(jIUjJj4!ubajMjŠubjbXž 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.r;!…r!}r?!(jIUjJjojKjLjMj•jO}r@!(jT]jS]jQ]jR]jV]Uentries]rA!(j˜XHsetup-configure command line option; --enable-optimization[=n] or -O [n]jUNtrB!aujXNjYhjD]ubjš)rC!}rD!(jIUjJjojKjLjMjjO}rE!(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrF!j£jF!ujXNjYhjD]rG!(j¥)rH!}rI!(jIX#--enable-optimization[=n] or -O [n]jJjC!jKjLjMj¨jO}rJ!(jª]rK!X--enable-optimization[rL!ajT]rM!jajS]jQ]jR]jV]rN!hpaj°‰ujXMØjYhjD]rO!(j²)rP!}rQ!(jIjL!jJjH!jKjLjMjµjO}rR!(j½j¾jT]jS]jQ]jR]jV]ujXMØjYhjD]rS!jbX--enable-optimization[rT!…rU!}rV!(jIUjKNjXNjYhjJjP!ubaubj»)rW!}rX!(jIX =n] or -O [n]jJjH!jKjLjMj¾jO}rY!(j½j¾jT]jS]jQ]jR]jV]ujXMØjYhjD]rZ!jbX =n] or -O [n]r[!…r\!}r]!(jIUjKNjXNjYhjJjW!ubaubeubjÖ)r^!}r_!(jIUjJjC!jKjLjMjÙjO}r`!(jQ]jR]jS]jT]jV]ujXMØjYhjD]ra!(jy)rb!}rc!(jIX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.rd!jJj^!jKjLjMj|jO}re!(jQ]jR]jS]jT]jV]ujXMÌjYhjD]rf!jbX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.rg!…rh!}ri!(jIjd!jKNjXNjYhjJjb!ubaubjy)rj!}rk!(jIXtThe 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.jJj^!jKjLjMj|jO}rl!(jQ]jR]jS]jT]jV]ujXMÐjYhjD]rm!(jbX The optional rn!…ro!}rp!(jIX The optional jKNjXNjYhjJjj!ubj½)rq!}rr!(jIX*n*jO}rs!(jQ]jR]jS]jT]jV]ujJjj!jD]rt!jbXn…ru!}rv!(jIUjJjq!ubajMjÅubjbX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to rw!…rx!}ry!(jIX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to jKNjXNjYhjJjj!ubj­)rz!}r{!(jIX :option:`--disable-optimization`r|!jJjj!jKjLjMj±jO}r}!(UreftypeXoptionj³ˆj´X--disable-optimizationU refdomainXstdr~!jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÐjD]r!j‚)r€!}r!(jIj|!jO}r‚!(jQ]jR]rƒ!(j¾j~!X std-optionr„!ejS]jT]jV]ujJjz!jD]r…!jbX--disable-optimizationr†!…r‡!}rˆ!(jIUjJj€!ubajMjŠubaubjbX, level 1 is the default if no r‰!…rŠ!}r‹!(jIX, level 1 is the default if no jKNjXNjYhjJjj!ubj½)rŒ!}r!(jIX*n*jO}rŽ!(jQ]jR]jS]jT]jV]ujJjj!jD]r!jbXn…r!}r‘!(jIUjJjŒ!ubajMjÅubjbX 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”!(jIX 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.jKNjXNjYhjJjj!ubeubjy)r•!}r–!(jIXGWhen optimizations are enabled, Cabal passes ``-O2`` to the C compiler.jJj^!jKjLjMj|jO}r—!(jQ]jR]jS]jT]jV]ujXM×jYhjD]r˜!(jbX-When optimizations are enabled, Cabal passes r™!…rš!}r›!(jIX-When optimizations are enabled, Cabal passes jKNjXNjYhjJj•!ubj‚)rœ!}r!(jIX``-O2``jO}rž!(jQ]jR]jS]jT]jV]ujJj•!jD]rŸ!jbX-O2r !…r¡!}r¢!(jIUjJjœ!ubajMjŠubjbX to the C compiler.r£!…r¤!}r¥!(jIX to the C compiler.jKNjXNjYhjJj•!ubeubeubeubj’)r¦!}r§!(jIUjJjojKjLjMj•jO}r¨!(jT]jS]jQ]jR]jV]Uentries]r©!(j˜X;setup-configure command line option; --disable-optimizationhëUNtrª!aujXNjYhjD]ubjš)r«!}r¬!(jIUjJjojKjLjMjjO}r­!(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr®!j£j®!ujXNjYhjD]r¯!(j¥)r°!}r±!(jIX--disable-optimizationr²!jJj«!jKjLjMj¨jO}r³!(jª]r´!j²!ajT]rµ!hëajS]jQ]jR]jV]r¶!hEaj°‰ujXMÞjYhjD]r·!(j²)r¸!}r¹!(jIj²!jJj°!jKjLjMjµjO}rº!(j½j¾jT]jS]jQ]jR]jV]ujXMÞjYhjD]r»!jbX--disable-optimizationr¼!…r½!}r¾!(jIUjKNjXNjYhjJj¸!ubaubj»)r¿!}rÀ!(jIUjJj°!jKjLjMj¾jO}rÁ!(j½j¾jT]jS]jQ]jR]jV]ujXMÞjYhjD]ubeubjÖ)rÂ!}rÃ!(jIUjJj«!jKjLjMjÙjO}rÄ!(jQ]jR]jS]jT]jV]ujXMÞjYhjD]rÅ!jy)rÆ!}rÇ!(jIX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.rÈ!jJjÂ!jKjLjMj|jO}rÉ!(jQ]jR]jS]jT]jV]ujXMÛjYhjD]rÊ!jbX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.rË!…rÌ!}rÍ!(jIjÈ!jKNjXNjYhjJjÆ!ubaubaubeubj’)rÎ!}rÏ!(jIUjJjojKjLjMj•jO}rÐ!(jT]jS]jQ]jR]jV]Uentries]rÑ!(j˜X7setup-configure command line option; --enable-profilinghËUNtrÒ!aujXNjYhjD]ubjš)rÓ!}rÔ!(jIUjJjojKjLjMjjO}rÕ!(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÖ!j£jÖ!ujXNjYhjD]r×!(j¥)rØ!}rÙ!(jIX--enable-profilingrÚ!jJjÓ!jKjLjMj¨jO}rÛ!(jª]rÜ!jÚ!ajT]rÝ!hËajS]jQ]jR]jV]rÞ!h$aj°‰ujXMíjYhjD]rß!(j²)rà!}rá!(jIjÚ!jJjØ!jKjLjMjµjO}râ!(j½j¾jT]jS]jQ]jR]jV]ujXMíjYhjD]rã!jbX--enable-profilingrä!…rå!}ræ!(jIUjKNjXNjYhjJjà!ubaubj»)rç!}rè!(jIUjJjØ!jKjLjMj¾jO}ré!(j½j¾jT]jS]jQ]jR]jV]ujXMíjYhjD]ubeubjÖ)rê!}rë!(jIUjJjÓ!jKjLjMjÙjO}rì!(jQ]jR]jS]jT]jV]ujXMíjYhjD]rí!(jy)rî!}rï!(jIX¥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ð!jJjê!jKjLjMj|jO}rñ!(jQ]jR]jS]jT]jV]ujXMájYhjD]rò!jbX¥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õ!(jIjð!jKNjXNjYhjJjî!ubaubjy)rö!}r÷!(jIXxThis flag covers both libraries and executables, but can be overridden by the :option:`--enable-library-profiling` flag.jJjê!jKjLjMj|jO}rø!(jQ]jR]jS]jT]jV]ujXMéjYhjD]rù!(jbXNThis flag covers both libraries and executables, but can be overridden by the rú!…rû!}rü!(jIXNThis flag covers both libraries and executables, but can be overridden by the jKNjXNjYhjJjö!ubj­)rý!}rþ!(jIX$:option:`--enable-library-profiling`rÿ!jJjö!jKjLjMj±jO}r"(UreftypeXoptionj³ˆj´X--enable-library-profilingU refdomainXstdr"jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMéjD]r"j‚)r"}r"(jIjÿ!jO}r"(jQ]jR]r"(j¾j"X std-optionr"ejS]jT]jV]ujJjý!jD]r"jbX--enable-library-profilingr "…r "}r "(jIUjJj"ubajMjŠubaubjbX flag.r "…r "}r"(jIX flag.jKNjXNjYhjJjö!ubeubjy)r"}r"(jIX5See also the :option:`--profiling-detail` flag below.jJjê!jKjLjMj|jO}r"(jQ]jR]jS]jT]jV]ujXMìjYhjD]r"(jbX See also the r"…r"}r"(jIX See also the jKNjXNjYhjJj"ubj­)r"}r"(jIX:option:`--profiling-detail`r"jJj"jKjLjMj±jO}r"(UreftypeXoptionj³ˆj´X--profiling-detailU refdomainXstdr"jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMìjD]r"j‚)r"}r"(jIj"jO}r"(jQ]jR]r"(j¾j"X std-optionr "ejS]jT]jV]ujJj"jD]r!"jbX--profiling-detailr""…r#"}r$"(jIUjJj"ubajMjŠubaubjbX flag below.r%"…r&"}r'"(jIX flag below.jKNjXNjYhjJj"ubeubeubeubj’)r("}r)"(jIUjJjojKjLjMj•jO}r*"(jT]jS]jQ]jR]jV]Uentries]r+"(j˜X8setup-configure command line option; --disable-profilingjUNtr,"aujXNjYhjD]ubjš)r-"}r."(jIUjJjojKjLjMjjO}r/"(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr0"j£j0"ujXNjYhjD]r1"(j¥)r2"}r3"(jIX--disable-profilingr4"jJj-"jKjLjMj¨jO}r5"(jª]r6"j4"ajT]r7"jajS]jQ]jR]jV]r8"h[aj°‰ujXMòjYhjD]r9"(j²)r:"}r;"(jIj4"jJj2"jKjLjMjµjO}r<"(j½j¾jT]jS]jQ]jR]jV]ujXMòjYhjD]r="jbX--disable-profilingr>"…r?"}r@"(jIUjKNjXNjYhjJj:"ubaubj»)rA"}rB"(jIUjJj2"jKjLjMj¾jO}rC"(j½j¾jT]jS]jQ]jR]jV]ujXMòjYhjD]ubeubjÖ)rD"}rE"(jIUjJj-"jKjLjMjÙjO}rF"(jQ]jR]jS]jT]jV]ujXMòjYhjD]rG"jy)rH"}rI"(jIXI(default) Do not enable profiling in generated libraries and executables.rJ"jJjD"jKjLjMj|jO}rK"(jQ]jR]jS]jT]jV]ujXMðjYhjD]rL"jbXI(default) Do not enable profiling in generated libraries and executables.rM"…rN"}rO"(jIjJ"jKNjXNjYhjJjH"ubaubaubeubj’)rP"}rQ"(jIUjJjojKjLjMj•jO}rR"(jT]jS]jQ]jR]jV]Uentries]rS"(j˜XEsetup-configure command line option; --enable-library-profiling or -phÀUNtrT"aujXNjYhjD]ubjš)rU"}rV"(jIUjJjojKjLjMjjO}rW"(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrX"j£jX"ujXNjYhjD]rY"(j¥)rZ"}r["(jIX --enable-library-profiling or -pjJjU"jKjLjMj¨jO}r\"(jª]r]"X--enable-library-profilingr^"ajT]r_"hÀajS]jQ]jR]jV]r`"haj°‰ujXMýjYhjD]ra"(j²)rb"}rc"(jIj^"jJjZ"jKjLjMjµjO}rd"(j½j¾jT]jS]jQ]jR]jV]ujXMýjYhjD]re"jbX--enable-library-profilingrf"…rg"}rh"(jIUjKNjXNjYhjJjb"ubaubj»)ri"}rj"(jIX or -pjJjZ"jKjLjMj¾jO}rk"(j½j¾jT]jS]jQ]jR]jV]ujXMýjYhjD]rl"jbX or -prm"…rn"}ro"(jIUjKNjXNjYhjJji"ubaubeubjÖ)rp"}rq"(jIUjJjU"jKjLjMjÙjO}rr"(jQ]jR]jS]jT]jV]ujXMýjYhjD]rs"(jy)rt"}ru"(jIXÂ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.jJjp"jKjLjMj|jO}rv"(jQ]jR]jS]jT]jV]ujXMõjYhjD]rw"(jbXAs with rx"…ry"}rz"(jIXAs with jKNjXNjYhjJjt"ubj­)r{"}r|"(jIX:option:`--enable-profiling`r}"jJjt"jKjLjMj±jO}r~"(UreftypeXoptionj³ˆj´X--enable-profilingU refdomainXstdr"jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMõjD]r€"j‚)r"}r‚"(jIj}"jO}rƒ"(jQ]jR]r„"(j¾j"X std-optionr…"ejS]jT]jV]ujJj{"jD]r†"jbX--enable-profilingr‡"…rˆ"}r‰"(jIUjJj"ubajMjŠubaubjbXž 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.rŠ"…r‹"}rŒ"(jIXž 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.jKNjXNjYhjJjt"ubeubjy)r"}rŽ"(jIXà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.jJjp"jKjLjMj|jO}r"(jQ]jR]jS]jT]jV]ujXMùjYhjD]r"(jbXThe r‘"…r’"}r“"(jIXThe jKNjXNjYhjJj"ubj­)r”"}r•"(jIX:option:`--enable-profiling`r–"jJj"jKjLjMj±jO}r—"(UreftypeXoptionj³ˆj´X--enable-profilingU refdomainXstdr˜"jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMùjD]r™"j‚)rš"}r›"(jIj–"jO}rœ"(jQ]jR]r"(j¾j˜"X std-optionrž"ejS]jT]jV]ujJj”"jD]rŸ"jbX--enable-profilingr "…r¡"}r¢"(jIUjJjš"ubajMjŠubaubjbX“ 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¥"(jIX“ flag controls the profiling mode for both libraries and executables, but if different modes are desired for libraries versus executables then use jKNjXNjYhjJj"ubj­)r¦"}r§"(jIX$:option:`--enable-library-profiling`r¨"jJj"jKjLjMj±jO}r©"(UreftypeXoptionj³ˆj´X--enable-library-profilingU refdomainXstdrª"jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMùjD]r«"j‚)r¬"}r­"(jIj¨"jO}r®"(jQ]jR]r¯"(j¾jª"X std-optionr°"ejS]jT]jV]ujJj¦"jD]r±"jbX--enable-library-profilingr²"…r³"}r´"(jIUjJj¬"ubajMjŠubaubjbX as well.rµ"…r¶"}r·"(jIX as well.jKNjXNjYhjJj"ubeubeubeubj’)r¸"}r¹"(jIUjJjojKjLjMj•jO}rº"(jT]jS]jQ]jR]jV]Uentries]r»"(j˜X@setup-configure command line option; --disable-library-profilinghàUNtr¼"aujXNjYhjD]ubjš)r½"}r¾"(jIUjJjojKjLjMjjO}r¿"(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÀ"j£jÀ"ujXNjYhjD]rÁ"(j¥)rÂ"}rÃ"(jIX--disable-library-profilingrÄ"jJj½"jKjLjMj¨jO}rÅ"(jª]rÆ"jÄ"ajT]rÇ"hàajS]jQ]jR]jV]rÈ"h9aj°‰ujXMjYhjD]rÉ"(j²)rÊ"}rË"(jIjÄ"jJjÂ"jKjLjMjµjO}rÌ"(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÍ"jbX--disable-library-profilingrÎ"…rÏ"}rÐ"(jIUjKNjXNjYhjJjÊ"ubaubj»)rÑ"}rÒ"(jIUjJjÂ"jKjLjMj¾jO}rÓ"(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubeubjÖ)rÔ"}rÕ"(jIUjJj½"jKjLjMjÙjO}rÖ"(jQ]jR]jS]jT]jV]ujXMjYhjD]r×"jy)rØ"}rÙ"(jIXI(default) Do not generate an additional profiling version of the library.rÚ"jJjÔ"jKjLjMj|jO}rÛ"(jQ]jR]jS]jT]jV]ujXMjYhjD]rÜ"jbXI(default) Do not generate an additional profiling version of the library.rÝ"…rÞ"}rß"(jIjÚ"jKNjXNjYhjJjØ"ubaubaubeubj’)rà"}rá"(jIUjJjojKjLjMj•jO}râ"(jT]jS]jQ]jR]jV]Uentries]rã"(j˜X?setup-configure command line option; --profiling-detail[=level]jUNträ"aujXNjYhjD]ubjš)rå"}ræ"(jIUjJjojKjLjMjjO}rç"(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrè"j£jè"ujXNjYhjD]ré"(j¥)rê"}rë"(jIX--profiling-detail[=level]rì"jJjå"jKjLjMj¨jO}rí"(jª]rî"X--profiling-detail[rï"ajT]rð"jajS]jQ]jR]jV]rñ"hhaj°‰ujXM&jYhjD]rò"(j²)ró"}rô"(jIjï"jJjê"jKjLjMjµjO}rõ"(j½j¾jT]jS]jQ]jR]jV]ujXM&jYhjD]rö"jbX--profiling-detail[r÷"…rø"}rù"(jIUjKNjXNjYhjJjó"ubaubj»)rú"}rû"(jIX=level]jJjê"jKjLjMj¾jO}rü"(j½j¾jT]jS]jQ]jR]jV]ujXM&jYhjD]rý"jbX=level]rþ"…rÿ"}r#(jIUjKNjXNjYhjJjú"ubaubeubjÖ)r#}r#(jIUjJjå"jKjLjMjÙjO}r#(jQ]jR]jS]jT]jV]ujXM&jYhjD]r#(jy)r#}r#(jIXGSome 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#jJj#jKjLjMj|jO}r#(jQ]jR]jS]jT]jV]ujXMjYhjD]r #jbXKSome 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 #(jIj#jKNjXNjYhjJj#ubaubjy)r #}r#(jIXxThis flag covers both libraries and executables, but can be overridden by the :option:`--library-profiling-detail` flag.jJj#jKjLjMj|jO}r#(jQ]jR]jS]jT]jV]ujXM jYhjD]r#(jbXNThis flag covers both libraries and executables, but can be overridden by the r#…r#}r#(jIXNThis flag covers both libraries and executables, but can be overridden by the jKNjXNjYhjJj #ubj­)r#}r#(jIX$:option:`--library-profiling-detail`r#jJj #jKjLjMj±jO}r#(UreftypeXoptionj³ˆj´X--library-profiling-detailU refdomainXstdr#jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM jD]r#j‚)r#}r#(jIj#jO}r#(jQ]jR]r#(j¾j#X std-optionr#ejS]jT]jV]ujJj#jD]r#jbX--library-profiling-detailr #…r!#}r"#(jIUjJj#ubajMjŠubaubjbX flag.r##…r$#}r%#(jIX flag.jKNjXNjYhjJj #ubeubjy)r&#}r'#(jIXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:r(#jJj#jKjLjMj|jO}r)#(jQ]jR]jS]jT]jV]ujXM jYhjD]r*#jbXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:r+#…r,#}r-#(jIj(#jKNjXNjYhjJj&#ubaubjÒ)r.#}r/#(jIUjJj#jKjLjMjÕjO}r0#(jQ]jR]jS]jT]jV]ujXNjYhjD]r1#(jØ)r2#}r3#(jIXjdefault For GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jJj.#jKjLjMjÛjO}r4#(jQ]jR]jS]jT]jV]ujXMjD]r5#(jÞ)r6#}r7#(jIXdefaultr8#jJj2#jKjLjMjâjO}r9#(jQ]jR]jS]jT]jV]ujXMjD]r:#jbXdefaultr;#…r<#}r=#(jIj8#jJj6#ubaubjè)r>#}r?#(jIUjO}r@#(jQ]jR]jS]jT]jV]ujJj2#jD]rA#jy)rB#}rC#(jIXbFor GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jJj>#jKjLjMj|jO}rD#(jQ]jR]jS]jT]jV]ujXMjD]rE#(jbXFor GHC this uses rF#…rG#}rH#(jIXFor GHC this uses jJjB#ubj‚)rI#}rJ#(jIX``exported-functions``jO}rK#(jQ]jR]jS]jT]jV]ujJjB#jD]rL#jbXexported-functionsrM#…rN#}rO#(jIUjJjI#ubajMjŠubjbX for libraries and rP#…rQ#}rR#(jIX for libraries and jJjB#ubj‚)rS#}rT#(jIX``toplevel-functions``jO}rU#(jQ]jR]jS]jT]jV]ujJjB#jD]rV#jbXtoplevel-functionsrW#…rX#}rY#(jIUjJjS#ubajMjŠubjbX for executables.rZ#…r[#}r\#(jIX for executables.jJjB#ubeubajMjþubeubjØ)r]#}r^#(jIXAnone No costs will be assigned to any code within this component.jJj.#jKjLjMjÛjO}r_#(jQ]jR]jS]jT]jV]ujXMjYhjD]r`#(jÞ)ra#}rb#(jIXnonerc#jJj]#jKjLjMjâjO}rd#(jQ]jR]jS]jT]jV]ujXMjD]re#jbXnonerf#…rg#}rh#(jIjc#jJja#ubaubjè)ri#}rj#(jIUjO}rk#(jQ]jR]jS]jT]jV]ujJj]#jD]rl#jy)rm#}rn#(jIX<No costs will be assigned to any code within this component.ro#jJji#jKjLjMj|jO}rp#(jQ]jR]jS]jT]jV]ujXMjD]rq#jbX<No costs will be assigned to any code within this component.rr#…rs#}rt#(jIjo#jJjm#ubaubajMjþubeubjØ)ru#}rv#(jIX©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.jJj.#jKjLjMjÛjO}rw#(jQ]jR]jS]jT]jV]ujXMjYhjD]rx#(jÞ)ry#}rz#(jIXexported-functionsr{#jJju#jKjLjMjâjO}r|#(jQ]jR]jS]jT]jV]ujXMjD]r}#jbXexported-functionsr~#…r#}r€#(jIj{#jJjy#ubaubjè)r#}r‚#(jIUjO}rƒ#(jQ]jR]jS]jT]jV]ujJju#jD]r„#jy)r…#}r†#(jIX–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.r‡#jJj#jKjLjMj|jO}rˆ#(jQ]jR]jS]jT]jV]ujXMjD]r‰#jbX–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.rŠ#…r‹#}rŒ#(jIj‡#jJj…#ubaubajMjþubeubjØ)r#}rŽ#(jIXÐ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.jJj.#jKjLjMjÛjO}r#(jQ]jR]jS]jT]jV]ujXMjYhjD]r#(jÞ)r‘#}r’#(jIXtoplevel-functionsr“#jJj#jKjLjMjâjO}r”#(jQ]jR]jS]jT]jV]ujXMjD]r•#jbXtoplevel-functionsr–#…r—#}r˜#(jIj“#jJj‘#ubaubjè)r™#}rš#(jIUjO}r›#(jQ]jR]jS]jT]jV]ujJj#jD]rœ#jy)r#}rž#(jIX½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Ÿ#jJj™#jKjLjMj|jO}r #(jQ]jR]jS]jT]jV]ujXMjD]r¡#jbX½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¤#(jIjŸ#jJj#ubaubajMjþubeubjØ)r¥#}r¦#(jIXÎ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. jJj.#jKjLjMjÛjO}r§#(jQ]jR]jS]jT]jV]ujXM"jYhjD]r¨#(jÞ)r©#}rª#(jIX all-functionsr«#jJj¥#jKjLjMjâjO}r¬#(jQ]jR]jS]jT]jV]ujXM"jD]r­#jbX all-functionsr®#…r¯#}r°#(jIj«#jJj©#ubaubjè)r±#}r²#(jIUjO}r³#(jQ]jR]jS]jT]jV]ujJj¥#jD]r´#jy)rµ#}r¶#(jIX¿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·#jJj±#jKjLjMj|jO}r¸#(jQ]jR]jS]jT]jV]ujXMjD]r¹#jbX¿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¼#(jIj·#jJjµ#ubaubajMjþubeubeubjy)r½#}r¾#(jIXUThis flag is new in Cabal-1.24. Prior versions used the equivalent of ``none`` above.jJj#jKjLjMj|jO}r¿#(jQ]jR]jS]jT]jV]ujXM$jYhjD]rÀ#(jbXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of rÁ#…rÂ#}rÃ#(jIXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of jKNjXNjYhjJj½#ubj‚)rÄ#}rÅ#(jIX``none``jO}rÆ#(jQ]jR]jS]jT]jV]ujJj½#jD]rÇ#jbXnonerÈ#…rÉ#}rÊ#(jIUjJjÄ#ubajMjŠubjbX above.rË#…rÌ#}rÍ#(jIX above.jKNjXNjYhjJj½#ubeubeubeubj’)rÎ#}rÏ#(jIUjJjojKjLjMj•jO}rÐ#(jT]jS]jQ]jR]jV]Uentries]rÑ#(j˜XGsetup-configure command line option; --library-profiling-detail[=level]hñUNtrÒ#aujXNjYhjD]ubjš)rÓ#}rÔ#(jIUjJjojKjLjMjjO}rÕ#(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÖ#j£jÖ#ujXNjYhjD]r×#(j¥)rØ#}rÙ#(jIX"--library-profiling-detail[=level]jJjÓ#jKjLjMj¨jO}rÚ#(jª]rÛ#X--library-profiling-detail[rÜ#ajT]rÝ#hñajS]jQ]jR]jV]rÞ#hKaj°‰ujXM0jYhjD]rß#(j²)rà#}rá#(jIjÜ#jJjØ#jKjLjMjµjO}râ#(j½j¾jT]jS]jQ]jR]jV]ujXM0jYhjD]rã#jbX--library-profiling-detail[rä#…rå#}ræ#(jIUjKNjXNjYhjJjà#ubaubj»)rç#}rè#(jIX=level]jJjØ#jKjLjMj¾jO}ré#(j½j¾jT]jS]jQ]jR]jV]ujXM0jYhjD]rê#jbX=level]rë#…rì#}rí#(jIUjKNjXNjYhjJjç#ubaubeubjÖ)rî#}rï#(jIUjJjÓ#jKjLjMjÙjO}rð#(jQ]jR]jS]jT]jV]ujXM0jYhjD]rñ#(jy)rò#}ró#(jIXNAs with :option:`--profiling-detail` above, but it applies only for libraries.jJjî#jKjLjMj|jO}rô#(jQ]jR]jS]jT]jV]ujXM)jYhjD]rõ#(jbXAs with rö#…r÷#}rø#(jIXAs with jKNjXNjYhjJjò#ubj­)rù#}rú#(jIX:option:`--profiling-detail`rû#jJjò#jKjLjMj±jO}rü#(UreftypeXoptionj³ˆj´X--profiling-detailU refdomainXstdrý#jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM)jD]rþ#j‚)rÿ#}r$(jIjû#jO}r$(jQ]jR]r$(j¾jý#X std-optionr$ejS]jT]jV]ujJjù#jD]r$jbX--profiling-detailr$…r$}r$(jIUjJjÿ#ubajMjŠubaubjbX* above, but it applies only for libraries.r$…r $}r $(jIX* above, but it applies only for libraries.jKNjXNjYhjJjò#ubeubjy)r $}r $(jIXÙ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.jJjî#jKjLjMj|jO}r $(jQ]jR]jS]jT]jV]ujXM,jYhjD]r$(jbX;The level for both libraries and executables is set by the r$…r$}r$(jIX;The level for both libraries and executables is set by the jKNjXNjYhjJj $ubj­)r$}r$(jIX:option:`--profiling-detail`r$jJj $jKjLjMj±jO}r$(UreftypeXoptionj³ˆj´X--profiling-detailU refdomainXstdr$jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM,jD]r$j‚)r$}r$(jIj$jO}r$(jQ]jR]r$(j¾j$X std-optionr$ejS]jT]jV]ujJj$jD]r$jbX--profiling-detailr$…r$}r $(jIUjJj$ubajMjŠubaubjbXU flag, but if different levels are desired for libraries versus executables then use r!$…r"$}r#$(jIXU flag, but if different levels are desired for libraries versus executables then use jKNjXNjYhjJj $ubj­)r$$}r%$(jIX$:option:`--library-profiling-detail`r&$jJj $jKjLjMj±jO}r'$(UreftypeXoptionj³ˆj´X--library-profiling-detailU refdomainXstdr($jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM,jD]r)$j‚)r*$}r+$(jIj&$jO}r,$(jQ]jR]r-$(j¾j($X std-optionr.$ejS]jT]jV]ujJj$$jD]r/$jbX--library-profiling-detailr0$…r1$}r2$(jIUjJj*$ubajMjŠubaubjbX as well.r3$…r4$}r5$(jIX as well.jKNjXNjYhjJj $ubeubeubeubj’)r6$}r7$(jIUjJjojKjLjMj•jO}r8$(jT]jS]jQ]jR]jV]Uentries]r9$(j˜X=setup-configure command line option; --enable-library-vanillaj UNtr:$aujXNjYhjD]ubjš)r;$}r<$(jIUjJjojKjLjMjjO}r=$(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr>$j£j>$ujXNjYhjD]r?$(j¥)r@$}rA$(jIX--enable-library-vanillarB$jJj;$jKjLjMj¨jO}rC$(jª]rD$jB$ajT]rE$j ajS]jQ]jR]jV]rF$hgaj°‰ujXM7jYhjD]rG$(j²)rH$}rI$(jIjB$jJj@$jKjLjMjµjO}rJ$(j½j¾jT]jS]jQ]jR]jV]ujXM7jYhjD]rK$jbX--enable-library-vanillarL$…rM$}rN$(jIUjKNjXNjYhjJjH$ubaubj»)rO$}rP$(jIUjJj@$jKjLjMj¾jO}rQ$(j½j¾jT]jS]jQ]jR]jV]ujXM7jYhjD]ubeubjÖ)rR$}rS$(jIUjJj;$jKjLjMjÙjO}rT$(jQ]jR]jS]jT]jV]ujXM7jYhjD]rU$jy)rV$}rW$(jIX±(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.jJjR$jKjLjMj|jO}rX$(jQ]jR]jS]jT]jV]ujXM3jYhjD]rY$(jbXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the rZ$…r[$}r\$(jIXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the jKNjXNjYhjJjV$ubj­)r]$}r^$(jIX$:option:`--enable-library-profiling`r_$jJjV$jKjLjMj±jO}r`$(UreftypeXoptionj³ˆj´X--enable-library-profilingU refdomainXstdra$jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM3jD]rb$j‚)rc$}rd$(jIj_$jO}re$(jQ]jR]rf$(j¾ja$X std-optionrg$ejS]jT]jV]ujJj]$jD]rh$jbX--enable-library-profilingri$…rj$}rk$(jIUjJjc$ubajMjŠubaubjbX* option. If you enable both, you get both.rl$…rm$}rn$(jIX* option. If you enable both, you get both.jKNjXNjYhjJjV$ubeubaubeubj’)ro$}rp$(jIUjJjojKjLjMj•jO}rq$(jT]jS]jQ]jR]jV]Uentries]rr$(j˜X>setup-configure command line option; --disable-library-vanillah¼UNtrs$aujXNjYhjD]ubjš)rt$}ru$(jIUjJjojKjLjMjjO}rv$(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrw$j£jw$ujXNjYhjD]rx$(j¥)ry$}rz$(jIX--disable-library-vanillar{$jJjt$jKjLjMj¨jO}r|$(jª]r}$j{$ajT]r~$h¼ajS]jQ]jR]jV]r$haj°‰ujXM=jYhjD]r€$(j²)r$}r‚$(jIj{$jJjy$jKjLjMjµjO}rƒ$(j½j¾jT]jS]jQ]jR]jV]ujXM=jYhjD]r„$jbX--disable-library-vanillar…$…r†$}r‡$(jIUjKNjXNjYhjJj$ubaubj»)rˆ$}r‰$(jIUjJjy$jKjLjMj¾jO}rŠ$(j½j¾jT]jS]jQ]jR]jV]ujXM=jYhjD]ubeubjÖ)r‹$}rŒ$(jIUjJjt$jKjLjMjÙjO}r$(jQ]jR]jS]jT]jV]ujXM=jYhjD]rŽ$jy)r$}r$(jIX¹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.jJj‹$jKjLjMj|jO}r‘$(jQ]jR]jS]jT]jV]ujXM:jYhjD]r’$(jbXDDo not build ordinary libraries. This is useful in conjunction with r“$…r”$}r•$(jIXDDo not build ordinary libraries. This is useful in conjunction with jKNjXNjYhjJj$ubj­)r–$}r—$(jIX$:option:`--enable-library-profiling`r˜$jJj$jKjLjMj±jO}r™$(UreftypeXoptionj³ˆj´X--enable-library-profilingU refdomainXstdrš$jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM:jD]r›$j‚)rœ$}r$(jIj˜$jO}rž$(jQ]jR]rŸ$(j¾jš$X std-optionr $ejS]jT]jV]ujJj–$jD]r¡$jbX--enable-library-profilingr¢$…r£$}r¤$(jIUjJjœ$ubajMjŠubaubjbXQ to build only profiling libraries, rather than profiling and ordinary libraries.r¥$…r¦$}r§$(jIXQ to build only profiling libraries, rather than profiling and ordinary libraries.jKNjXNjYhjJj$ubeubaubeubj’)r¨$}r©$(jIUjJjojKjLjMj•jO}rª$(jT]jS]jQ]jR]jV]Uentries]r«$(j˜X>setup-configure command line option; --enable-library-for-ghcih¯UNtr¬$aujXNjYhjD]ubjš)r­$}r®$(jIUjJjojKjLjMjjO}r¯$(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr°$j£j°$ujXNjYhjD]r±$(j¥)r²$}r³$(jIX--enable-library-for-ghcir´$jJj­$jKjLjMj¨jO}rµ$(jª]r¶$j´$ajT]r·$h¯ajS]jQ]jR]jV]r¸$haj°‰ujXMAjYhjD]r¹$(j²)rº$}r»$(jIj´$jJj²$jKjLjMjµjO}r¼$(j½j¾jT]jS]jQ]jR]jV]ujXMAjYhjD]r½$jbX--enable-library-for-ghcir¾$…r¿$}rÀ$(jIUjKNjXNjYhjJjº$ubaubj»)rÁ$}rÂ$(jIUjJj²$jKjLjMj¾jO}rÃ$(j½j¾jT]jS]jQ]jR]jV]ujXMAjYhjD]ubeubjÖ)rÄ$}rÅ$(jIUjJj­$jKjLjMjÙjO}rÆ$(jQ]jR]jS]jT]jV]ujXMAjYhjD]rÇ$jy)rÈ$}rÉ$(jIX5(default) Build libraries suitable for use with GHCi.rÊ$jJjÄ$jKjLjMj|jO}rË$(jQ]jR]jS]jT]jV]ujXM@jYhjD]rÌ$jbX5(default) Build libraries suitable for use with GHCi.rÍ$…rÎ$}rÏ$(jIjÊ$jKNjXNjYhjJjÈ$ubaubaubeubj’)rÐ$}rÑ$(jIUjJjojKjLjMj•jO}rÒ$(jT]jS]jQ]jR]jV]Uentries]rÓ$(j˜X?setup-configure command line option; --disable-library-for-ghcihÂUNtrÔ$aujXNjYhjD]ubjš)rÕ$}rÖ$(jIUjJjojKjLjMjjO}r×$(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrØ$j£jØ$ujXNjYhjD]rÙ$(j¥)rÚ$}rÛ$(jIX--disable-library-for-ghcirÜ$jJjÕ$jKjLjMj¨jO}rÝ$(jª]rÞ$jÜ$ajT]rß$hÂajS]jQ]jR]jV]rà$haj°‰ujXMGjYhjD]rá$(j²)râ$}rã$(jIjÜ$jJjÚ$jKjLjMjµjO}rä$(j½j¾jT]jS]jQ]jR]jV]ujXMGjYhjD]rå$jbX--disable-library-for-ghciræ$…rç$}rè$(jIUjKNjXNjYhjJjâ$ubaubj»)ré$}rê$(jIUjJjÚ$jKjLjMj¾jO}rë$(j½j¾jT]jS]jQ]jR]jV]ujXMGjYhjD]ubeubjÖ)rì$}rí$(jIUjJjÕ$jKjLjMjÙjO}rî$(jQ]jR]jS]jT]jV]ujXMGjYhjD]rï$jy)rð$}rñ$(jIX’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ò$jJjì$jKjLjMj|jO}ró$(jQ]jR]jS]jT]jV]ujXMDjYhjD]rô$jbX’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÷$(jIjò$jKNjXNjYhjJjð$ubaubaubeubj’)rø$}rù$(jIUjJjojKjLjMj•jO}rú$(jT]jS]jQ]jR]jV]Uentries]rû$(j˜X8setup-configure command line option; --enable-split-objshÆUNtrü$aujXNjYhjD]ubjš)rý$}rþ$(jIUjJjojKjLjMjjO}rÿ$(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr%j£j%ujXNjYhjD]r%(j¥)r%}r%(jIX--enable-split-objsr%jJjý$jKjLjMj¨jO}r%(jª]r%j%ajT]r%hÆajS]jQ]jR]jV]r%haj°‰ujXMOjYhjD]r %(j²)r %}r %(jIj%jJj%jKjLjMjµjO}r %(j½j¾jT]jS]jQ]jR]jV]ujXMOjYhjD]r %jbX--enable-split-objsr%…r%}r%(jIUjKNjXNjYhjJj %ubaubj»)r%}r%(jIUjJj%jKjLjMj¾jO}r%(j½j¾jT]jS]jQ]jR]jV]ujXMOjYhjD]ubeubjÖ)r%}r%(jIUjJjý$jKjLjMjÙjO}r%(jQ]jR]jS]jT]jV]ujXMOjYhjD]r%jy)r%}r%(jIX6Use 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.jJj%jKjLjMj|jO}r%(jQ]jR]jS]jT]jV]ujXMJjYhjD]r%(jbX Use the GHC r%…r%}r%(jIX Use the GHC jKNjXNjYhjJj%ubj‚)r%}r %(jIX``-split-objs``jO}r!%(jQ]jR]jS]jT]jV]ujJj%jD]r"%jbX -split-objsr#%…r$%}r%%(jIUjJj%ubajMjŠubjbX 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(%(jIX 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.jKNjXNjYhjJj%ubeubaubeubj’)r)%}r*%(jIUjJjojKjLjMj•jO}r+%(jT]jS]jQ]jR]jV]Uentries]r,%(j˜X9setup-configure command line option; --disable-split-objsj<UNtr-%aujXNjYhjD]ubjš)r.%}r/%(jIUjJjojKjLjMjjO}r0%(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr1%j£j1%ujXNjYhjD]r2%(j¥)r3%}r4%(jIX--disable-split-objsr5%jJj.%jKjLjMj¨jO}r6%(jª]r7%j5%ajT]r8%j<ajS]jQ]jR]jV]r9%hœaj°‰ujXMUjYhjD]r:%(j²)r;%}r<%(jIj5%jJj3%jKjLjMjµjO}r=%(j½j¾jT]jS]jQ]jR]jV]ujXMUjYhjD]r>%jbX--disable-split-objsr?%…r@%}rA%(jIUjKNjXNjYhjJj;%ubaubj»)rB%}rC%(jIUjJj3%jKjLjMj¾jO}rD%(j½j¾jT]jS]jQ]jR]jV]ujXMUjYhjD]ubeubjÖ)rE%}rF%(jIUjJj.%jKjLjMjÙjO}rG%(jQ]jR]jS]jT]jV]ujXMUjYhjD]rH%jy)rI%}rJ%(jIXœ(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.jJjE%jKjLjMj|jO}rK%(jQ]jR]jS]jT]jV]ujXMRjYhjD]rL%(jbX(default) Do not use the GHC rM%…rN%}rO%(jIX(default) Do not use the GHC jKNjXNjYhjJjI%ubj‚)rP%}rQ%(jIX``-split-objs``jO}rR%(jQ]jR]jS]jT]jV]ujJjI%jD]rS%jbX -split-objsrT%…rU%}rV%(jIUjJjP%ubajMjŠubjbXp feature. This makes building the library quicker but the final executables that use the library will be larger.rW%…rX%}rY%(jIXp feature. This makes building the library quicker but the final executables that use the library will be larger.jKNjXNjYhjJjI%ubeubaubeubj’)rZ%}r[%(jIUjJjojKjLjMj•jO}r\%(jT]jS]jQ]jR]jV]Uentries]r]%(j˜XBsetup-configure command line option; --enable-executable-strippingh÷UNtr^%aujXNjYhjD]ubjš)r_%}r`%(jIUjJjojKjLjMjjO}ra%(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrb%j£jb%ujXNjYhjD]rc%(j¥)rd%}re%(jIX--enable-executable-strippingrf%jJj_%jKjLjMj¨jO}rg%(jª]rh%jf%ajT]ri%h÷ajS]jQ]jR]jV]rj%hQaj°‰ujXMajYhjD]rk%(j²)rl%}rm%(jIjf%jJjd%jKjLjMjµjO}rn%(j½j¾jT]jS]jQ]jR]jV]ujXMajYhjD]ro%jbX--enable-executable-strippingrp%…rq%}rr%(jIUjKNjXNjYhjJjl%ubaubj»)rs%}rt%(jIUjJjd%jKjLjMj¾jO}ru%(j½j¾jT]jS]jQ]jR]jV]ujXMajYhjD]ubeubjÖ)rv%}rw%(jIUjJj_%jKjLjMjÙjO}rx%(jQ]jR]jS]jT]jV]ujXMajYhjD]ry%(jy)rz%}r{%(jIX…(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.jJjv%jKjLjMj|jO}r|%(jQ]jR]jS]jT]jV]ujXMXjYhjD]r}%(jbX>(default) When installing binary executable programs, run the r~%…r%}r€%(jIX>(default) When installing binary executable programs, run the jKNjXNjYhjJjz%ubj‚)r%}r‚%(jIX ``strip``jO}rƒ%(jQ]jR]jS]jT]jV]ujJjz%jD]r„%jbXstripr…%…r†%}r‡%(jIUjJj%ubajMjŠubjbX> 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.rˆ%…r‰%}rŠ%(jIX> 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.jKNjXNjYhjJjz%ubeubjy)r‹%}rŒ%(jIXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r%jJjv%jKjLjMj|jO}rŽ%(jQ]jR]jS]jT]jV]ujXM_jYhjD]r%jbXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r%…r‘%}r’%(jIj%jKNjXNjYhjJj‹%ubaubeubeubj’)r“%}r”%(jIUjJjojKjLjMj•jO}r•%(jT]jS]jQ]jR]jV]Uentries]r–%(j˜XCsetup-configure command line option; --disable-executable-strippingj2UNtr—%aujXNjYhjD]ubjš)r˜%}r™%(jIUjJjojKjLjMjjO}rš%(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr›%j£j›%ujXNjYhjD]rœ%(j¥)r%}rž%(jIX--disable-executable-strippingrŸ%jJj˜%jKjLjMj¨jO}r %(jª]r¡%jŸ%ajT]r¢%j2ajS]jQ]jR]jV]r£%h’aj°‰ujXMjjYhjD]r¤%(j²)r¥%}r¦%(jIjŸ%jJj%jKjLjMjµjO}r§%(j½j¾jT]jS]jQ]jR]jV]ujXMjjYhjD]r¨%jbX--disable-executable-strippingr©%…rª%}r«%(jIUjKNjXNjYhjJj¥%ubaubj»)r¬%}r­%(jIUjJj%jKjLjMj¾jO}r®%(j½j¾jT]jS]jQ]jR]jV]ujXMjjYhjD]ubeubjÖ)r¯%}r°%(jIUjJj˜%jKjLjMjÙjO}r±%(jQ]jR]jS]jT]jV]ujXMjjYhjD]r²%jy)r³%}r´%(jIXtDo 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µ%jJj¯%jKjLjMj|jO}r¶%(jQ]jR]jS]jT]jV]ujXMdjYhjD]r·%jbXtDo 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º%(jIjµ%jKNjXNjYhjJj³%ubaubaubeubj’)r»%}r¼%(jIUjJjojKjLjMj•jO}r½%(jT]jS]jQ]jR]jV]Uentries]r¾%(j˜X4setup-configure command line option; --enable-sharedj*UNtr¿%aujXNjYhjD]ubjš)rÀ%}rÁ%(jIUjJjojKjLjMjjO}rÂ%(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÃ%j£jÃ%ujXNjYhjD]rÄ%(j¥)rÅ%}rÆ%(jIX--enable-sharedrÇ%jJjÀ%jKjLjMj¨jO}rÈ%(jª]rÉ%jÇ%ajT]rÊ%j*ajS]jQ]jR]jV]rË%h‰aj°‰ujXMojYhjD]rÌ%(j²)rÍ%}rÎ%(jIjÇ%jJjÅ%jKjLjMjµjO}rÏ%(j½j¾jT]jS]jQ]jR]jV]ujXMojYhjD]rÐ%jbX--enable-sharedrÑ%…rÒ%}rÓ%(jIUjKNjXNjYhjJjÍ%ubaubj»)rÔ%}rÕ%(jIUjJjÅ%jKjLjMj¾jO}rÖ%(j½j¾jT]jS]jQ]jR]jV]ujXMojYhjD]ubeubjÖ)r×%}rØ%(jIUjJjÀ%jKjLjMjÙjO}rÙ%(jQ]jR]jS]jT]jV]ujXMojYhjD]rÚ%jy)rÛ%}rÜ%(jIXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rÝ%jJj×%jKjLjMj|jO}rÞ%(jQ]jR]jS]jT]jV]ujXMmjYhjD]rß%jbXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rà%…rá%}râ%(jIjÝ%jKNjXNjYhjJjÛ%ubaubaubeubj’)rã%}rä%(jIUjJjojKjLjMj•jO}rå%(jT]jS]jQ]jR]jV]Uentries]ræ%(j˜X5setup-configure command line option; --disable-sharedhìUNtrç%aujXNjYhjD]ubjš)rè%}ré%(jIUjJjojKjLjMjjO}rê%(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrë%j£jë%ujXNjYhjD]rì%(j¥)rí%}rî%(jIX--disable-sharedrï%jJjè%jKjLjMj¨jO}rð%(jª]rñ%jï%ajT]rò%hìajS]jQ]jR]jV]ró%hFaj°‰ujXMsjYhjD]rô%(j²)rõ%}rö%(jIjï%jJjí%jKjLjMjµjO}r÷%(j½j¾jT]jS]jQ]jR]jV]ujXMsjYhjD]rø%jbX--disable-sharedrù%…rú%}rû%(jIUjKNjXNjYhjJjõ%ubaubj»)rü%}rý%(jIUjJjí%jKjLjMj¾jO}rþ%(j½j¾jT]jS]jQ]jR]jV]ujXMsjYhjD]ubeubjÖ)rÿ%}r&(jIUjJjè%jKjLjMjÙjO}r&(jQ]jR]jS]jT]jV]ujXMsjYhjD]r&jy)r&}r&(jIX&(default) Do not build shared library.r&jJjÿ%jKjLjMj|jO}r&(jQ]jR]jS]jT]jV]ujXMrjYhjD]r&jbX&(default) Do not build shared library.r&…r &}r &(jIj&jKNjXNjYhjJj&ubaubaubeubj’)r &}r &(jIUjJjojKjLjMj•jO}r &(jT]jS]jQ]jR]jV]Uentries]r&(j˜X4setup-configure command line option; --enable-staticj3UNtr&aujXNjYhjD]ubjš)r&}r&(jIUjJjojKjLjMjjO}r&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr&j£j&ujXNjYhjD]r&(j¥)r&}r&(jIX--enable-staticr&jJj&jKjLjMj¨jO}r&(jª]r&j&ajT]r&j3ajS]jQ]jR]jV]r&h“aj°‰ujXMyjYhjD]r&(j²)r&}r&(jIj&jJj&jKjLjMjµjO}r&(j½j¾jT]jS]jQ]jR]jV]ujXMyjYhjD]r &jbX--enable-staticr!&…r"&}r#&(jIUjKNjXNjYhjJj&ubaubj»)r$&}r%&(jIUjJj&jKjLjMj¾jO}r&&(j½j¾jT]jS]jQ]jR]jV]ujXMyjYhjD]ubeubjÖ)r'&}r(&(jIUjJj&jKjLjMjÙjO}r)&(jQ]jR]jS]jT]jV]ujXMyjYhjD]r*&jy)r+&}r,&(jIXÂBuild a static library. This passes ``-staticlib`` to GHC (available for iOS, and with 8.4 more platforms). The result is an archive ``.a`` containing all dependent haskell libararies combined.jJj'&jKjLjMj|jO}r-&(jQ]jR]jS]jT]jV]ujXMvjYhjD]r.&(jbX$Build a static library. This passes r/&…r0&}r1&(jIX$Build a static library. This passes jKNjXNjYhjJj+&ubj‚)r2&}r3&(jIX``-staticlib``jO}r4&(jQ]jR]jS]jT]jV]ujJj+&jD]r5&jbX -staticlibr6&…r7&}r8&(jIUjJj2&ubajMjŠubjbXT to GHC (available for iOS, and with 8.4 more platforms). The result is an archive r9&…r:&}r;&(jIXT to GHC (available for iOS, and with 8.4 more platforms). The result is an archive jKNjXNjYhjJj+&ubj‚)r<&}r=&(jIX``.a``jO}r>&(jQ]jR]jS]jT]jV]ujJj+&jD]r?&jbX.ar@&…rA&}rB&(jIUjJj<&ubajMjŠubjbX6 containing all dependent haskell libararies combined.rC&…rD&}rE&(jIX6 containing all dependent haskell libararies combined.jKNjXNjYhjJj+&ubeubaubeubj’)rF&}rG&(jIUjJjojKjLjMj•jO}rH&(jT]jS]jQ]jR]jV]Uentries]rI&(j˜X5setup-configure command line option; --disable-staticjUNtrJ&aujXNjYhjD]ubjš)rK&}rL&(jIUjJjojKjLjMjjO}rM&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrN&j£jN&ujXNjYhjD]rO&(j¥)rP&}rQ&(jIX--disable-staticrR&jJjK&jKjLjMj¨jO}rS&(jª]rT&jR&ajT]rU&jajS]jQ]jR]jV]rV&hoaj°‰ujXM}jYhjD]rW&(j²)rX&}rY&(jIjR&jJjP&jKjLjMjµjO}rZ&(j½j¾jT]jS]jQ]jR]jV]ujXM}jYhjD]r[&jbX--disable-staticr\&…r]&}r^&(jIUjKNjXNjYhjJjX&ubaubj»)r_&}r`&(jIUjJjP&jKjLjMj¾jO}ra&(j½j¾jT]jS]jQ]jR]jV]ujXM}jYhjD]ubeubjÖ)rb&}rc&(jIUjJjK&jKjLjMjÙjO}rd&(jQ]jR]jS]jT]jV]ujXM}jYhjD]re&jy)rf&}rg&(jIX((default) Do not build a static library.rh&jJjb&jKjLjMj|jO}ri&(jQ]jR]jS]jT]jV]ujXM|jYhjD]rj&jbX((default) Do not build a static library.rk&…rl&}rm&(jIjh&jKNjXNjYhjJjf&ubaubaubeubj’)rn&}ro&(jIUjJjojKjLjMj•jO}rp&(jT]jS]jQ]jR]jV]Uentries]rq&(j˜X@setup-configure command line option; --enable-executable-dynamicj"UNtrr&aujXNjYhjD]ubjš)rs&}rt&(jIUjJjojKjLjMjjO}ru&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrv&j£jv&ujXNjYhjD]rw&(j¥)rx&}ry&(jIX--enable-executable-dynamicrz&jJjs&jKjLjMj¨jO}r{&(jª]r|&jz&ajT]r}&j"ajS]jQ]jR]jV]r~&haj°‰ujXMƒjYhjD]r&(j²)r€&}r&(jIjz&jJjx&jKjLjMjµjO}r‚&(j½j¾jT]jS]jQ]jR]jV]ujXMƒjYhjD]rƒ&jbX--enable-executable-dynamicr„&…r…&}r†&(jIUjKNjXNjYhjJj€&ubaubj»)r‡&}rˆ&(jIUjJjx&jKjLjMj¾jO}r‰&(j½j¾jT]jS]jQ]jR]jV]ujXMƒjYhjD]ubeubjÖ)rŠ&}r‹&(jIUjJjs&jKjLjMjÙjO}rŒ&(jQ]jR]jS]jT]jV]ujXMƒjYhjD]r&jy)rŽ&}r&(jIXÈ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.jJjŠ&jKjLjMj|jO}r&(jQ]jR]jS]jT]jV]ujXM€jYhjD]r‘&(jbXvLink executables dynamically. The executable’s library dependencies should be built as shared objects. This implies r’&…r“&}r”&(jIXtLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies jKNjXNjYhjJjŽ&ubj­)r•&}r–&(jIX:option:`--enable-shared`r—&jJjŽ&jKjLjMj±jO}r˜&(UreftypeXoptionj³ˆj´X--enable-sharedU refdomainXstdr™&jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM€jD]rš&j‚)r›&}rœ&(jIj—&jO}r&(jQ]jR]rž&(j¾j™&X std-optionrŸ&ejS]jT]jV]ujJj•&jD]r &jbX--enable-sharedr¡&…r¢&}r£&(jIUjJj›&ubajMjŠubaubjbX unless r¤&…r¥&}r¦&(jIX unless jKNjXNjYhjJjŽ&ubj­)r§&}r¨&(jIX:option:`--disable-shared`r©&jJjŽ&jKjLjMj±jO}rª&(UreftypeXoptionj³ˆj´X--disable-sharedU refdomainXstdr«&jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXM€jD]r¬&j‚)r­&}r®&(jIj©&jO}r¯&(jQ]jR]r°&(j¾j«&X std-optionr±&ejS]jT]jV]ujJj§&jD]r²&jbX--disable-sharedr³&…r´&}rµ&(jIUjJj­&ubajMjŠubaubjbX is explicitly specified.r¶&…r·&}r¸&(jIX is explicitly specified.jKNjXNjYhjJjŽ&ubeubaubeubj’)r¹&}rº&(jIUjJjojKjLjMj•jO}r»&(jT]jS]jQ]jR]jV]Uentries]r¼&(j˜XAsetup-configure command line option; --disable-executable-dynamichûUNtr½&aujXNjYhjD]ubjš)r¾&}r¿&(jIUjJjojKjLjMjjO}rÀ&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÁ&j£jÁ&ujXNjYhjD]rÂ&(j¥)rÃ&}rÄ&(jIX--disable-executable-dynamicrÅ&jJj¾&jKjLjMj¨jO}rÆ&(jª]rÇ&jÅ&ajT]rÈ&hûajS]jQ]jR]jV]rÉ&hUaj°‰ujXM‡jYhjD]rÊ&(j²)rË&}rÌ&(jIjÅ&jJjÃ&jKjLjMjµjO}rÍ&(j½j¾jT]jS]jQ]jR]jV]ujXM‡jYhjD]rÎ&jbX--disable-executable-dynamicrÏ&…rÐ&}rÑ&(jIUjKNjXNjYhjJjË&ubaubj»)rÒ&}rÓ&(jIUjJjÃ&jKjLjMj¾jO}rÔ&(j½j¾jT]jS]jQ]jR]jV]ujXM‡jYhjD]ubeubjÖ)rÕ&}rÖ&(jIUjJj¾&jKjLjMjÙjO}r×&(jQ]jR]jS]jT]jV]ujXM‡jYhjD]rØ&jy)rÙ&}rÚ&(jIX&(default) Link executables statically.rÛ&jJjÕ&jKjLjMj|jO}rÜ&(jQ]jR]jS]jT]jV]ujXM†jYhjD]rÝ&jbX&(default) Link executables statically.rÞ&…rß&}rà&(jIjÛ&jKNjXNjYhjJjÙ&ubaubaubeubj’)rá&}râ&(jIUjJjojKjLjMj•jO}rã&(jT]jS]jQ]jR]jV]Uentries]rä&(j˜X;setup-configure command line option; --configure-option=strj UNtrå&aujXNjYhjD]ubjš)ræ&}rç&(jIUjJjojKjLjMjjO}rè&(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionré&j£jé&ujXNjYhjD]rê&(j¥)rë&}rì&(jIX--configure-option=strjJjæ&jKjLjMj¨jO}rí&(jª]rî&X--configure-optionrï&ajT]rð&j ajS]jQ]jR]jV]rñ&heaj°‰ujXMŽjYhjD]rò&(j²)ró&}rô&(jIjï&jJjë&jKjLjMjµjO}rõ&(j½j¾jT]jS]jQ]jR]jV]ujXMŽjYhjD]rö&jbX--configure-optionr÷&…rø&}rù&(jIUjKNjXNjYhjJjó&ubaubj»)rú&}rû&(jIX=strjJjë&jKjLjMj¾jO}rü&(j½j¾jT]jS]jQ]jR]jV]ujXMŽjYhjD]rý&jbX=strrþ&…rÿ&}r'(jIUjKNjXNjYhjJjú&ubaubeubjÖ)r'}r'(jIUjJjæ&jKjLjMjÙjO}r'(jQ]jR]jS]jT]jV]ujXMŽjYhjD]r'jy)r'}r'(jIX×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.jJj'jKjLjMj|jO}r'(jQ]jR]jS]jT]jV]ujXMŠjYhjD]r'(jbXAn extra option to an external r '…r '}r '(jIXAn extra option to an external jKNjXNjYhjJj'ubj‚)r '}r '(jIX ``configure``jO}r'(jQ]jR]jS]jT]jV]ujJj'jD]r'jbX configurer'…r'}r'(jIUjJj 'ubajMjŠubjbX, script, if one is used (see the section on r'…r'}r'(jIX, script, if one is used (see the section on jKNjXNjYhjJj'ubjœ)r'}r'(jIXV`system-dependent parameters `__jO}r'(UnameXsystem-dependent parametersjêX4developing-packages.html#system-dependent-parametersjT]jS]jQ]jR]jV]ujJj'jD]r'jbXsystem-dependent parametersr'…r'}r'(jIUjJj'ubajMj¥ubjbX)). There can be several of these options.r'…r'}r'(jIX)). There can be several of these options.jKNjXNjYhjJj'ubeubaubeubj’)r '}r!'(jIUjJjojKjLjMj•jO}r"'(jT]jS]jQ]jR]jV]Uentries]r#'(j˜X?setup-configure command line option; --extra-include-dirs[=dir]hùUNtr$'aujXNjYhjD]ubjš)r%'}r&'(jIUjJjojKjLjMjjO}r''(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr('j£j('ujXNjYhjD]r)'(j¥)r*'}r+'(jIX--extra-include-dirs[=dir]jJj%'jKjLjMj¨jO}r,'(jª]r-'X--extra-include-dirs[r.'ajT]r/'hùajS]jQ]jR]jV]r0'hSaj°‰ujXMjYhjD]r1'(j²)r2'}r3'(jIj.'jJj*'jKjLjMjµjO}r4'(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r5'jbX--extra-include-dirs[r6'…r7'}r8'(jIUjKNjXNjYhjJj2'ubaubj»)r9'}r:'(jIX=dir]jJj*'jKjLjMj¾jO}r;'(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r<'jbX=dir]r='…r>'}r?'(jIUjKNjXNjYhjJj9'ubaubeubjÖ)r@'}rA'(jIUjJj%'jKjLjMjÙjO}rB'(jQ]jR]jS]jT]jV]ujXMjYhjD]rC'(jy)rD'}rE'(jIXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rF'jJj@'jKjLjMj|jO}rG'(jQ]jR]jS]jT]jV]ujXM‘jYhjD]rH'jbXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rI'…rJ'}rK'(jIjF'jKNjXNjYhjJjD'ubaubjy)rL'}rM'(jIXPYou 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.jJj@'jKjLjMj|jO}rN'(jQ]jR]jS]jT]jV]ujXM”jYhjD]rO'(jbXYou 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 rP'…rQ'}rR'(jIX‹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 jKNjXNjYhjJjL'ubj‚)rS'}rT'(jIX ``.cabal``jO}rU'(jQ]jR]jS]jT]jV]ujJjL'jD]rV'jbX.cabalrW'…rX'}rY'(jIUjJjS'ubajMjŠubjbXH file. Using this option has the same affect as appending the directory rZ'…r['}r\'(jIXH file. Using this option has the same affect as appending the directory jKNjXNjYhjJjL'ubj½)r]'}r^'(jIX*dir*jO}r_'(jQ]jR]jS]jT]jV]ujJjL'jD]r`'jbXdirra'…rb'}rc'(jIUjJj]'ubajMjÅubjbX to the rd'…re'}rf'(jIX to the jKNjXNjYhjJjL'ubj‚)rg'}rh'(jIX``include-dirs``jO}ri'(jQ]jR]jS]jT]jV]ujJjL'jD]rj'jbX include-dirsrk'…rl'}rm'(jIUjJjg'ubajMjŠubjbX9 field in each library and executable in the package’s rn'…ro'}rp'(jIX7 field in each library and executable in the package's jKNjXNjYhjJjL'ubj‚)rq'}rr'(jIX ``.cabal``jO}rs'(jQ]jR]jS]jT]jV]ujJjL'jD]rt'jbX.cabalru'…rv'}rw'(jIUjJjq'ubajMjŠubjbX 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.rx'…ry'}rz'(jIX 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.jKNjXNjYhjJjL'ubeubeubeubj’)r{'}r|'(jIUjJjojKjLjMj•jO}r}'(jT]jS]jQ]jR]jV]Uentries]r~'(j˜X;setup-configure command line option; --extra-lib-dirs[=dir]hÏUNtr'aujXNjYhjD]ubjš)r€'}r'(jIUjJjojKjLjMjjO}r‚'(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrƒ'j£jƒ'ujXNjYhjD]r„'(j¥)r…'}r†'(jIX--extra-lib-dirs[=dir]jJj€'jKjLjMj¨jO}r‡'(jª]rˆ'X--extra-lib-dirs[r‰'ajT]rŠ'hÏajS]jQ]jR]jV]r‹'h(aj°‰ujXM¢jYhjD]rŒ'(j²)r'}rŽ'(jIj‰'jJj…'jKjLjMjµjO}r'(j½j¾jT]jS]jQ]jR]jV]ujXM¢jYhjD]r'jbX--extra-lib-dirs[r‘'…r’'}r“'(jIUjKNjXNjYhjJj'ubaubj»)r”'}r•'(jIX=dir]jJj…'jKjLjMj¾jO}r–'(j½j¾jT]jS]jQ]jR]jV]ujXM¢jYhjD]r—'jbX=dir]r˜'…r™'}rš'(jIUjKNjXNjYhjJj”'ubaubeubjÖ)r›'}rœ'(jIUjJj€'jKjLjMjÙjO}r'(jQ]jR]jS]jT]jV]ujXM¢jYhjD]rž'jy)rŸ'}r '(jIX{An extra directory to search for system libraries files. You can use this flag multiple times to get a list of directories.r¡'jJj›'jKjLjMj|jO}r¢'(jQ]jR]jS]jT]jV]ujXM jYhjD]r£'jbX{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¦'(jIj¡'jKNjXNjYhjJjŸ'ubaubaubeubj’)r§'}r¨'(jIUjJjojKjLjMj•jO}r©'(jT]jS]jQ]jR]jV]Uentries]rª'(j˜XAsetup-configure command line option; --extra-framework-dirs[=dir]j>UNtr«'aujXNjYhjD]ubjš)r¬'}r­'(jIUjJjojKjLjMjjO}r®'(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr¯'j£j¯'ujXNjYhjD]r°'(j¥)r±'}r²'(jIX--extra-framework-dirs[=dir]jJj¬'jKjLjMj¨jO}r³'(jª]r´'X--extra-framework-dirs[rµ'ajT]r¶'j>ajS]jQ]jR]jV]r·'hžaj°‰ujXM±jYhjD]r¸'(j²)r¹'}rº'(jIjµ'jJj±'jKjLjMjµjO}r»'(j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]r¼'jbX--extra-framework-dirs[r½'…r¾'}r¿'(jIUjKNjXNjYhjJj¹'ubaubj»)rÀ'}rÁ'(jIX=dir]jJj±'jKjLjMj¾jO}rÂ'(j½j¾jT]jS]jQ]jR]jV]ujXM±jYhjD]rÃ'jbX=dir]rÄ'…rÅ'}rÆ'(jIUjKNjXNjYhjJjÀ'ubaubeubjÖ)rÇ'}rÈ'(jIUjJj¬'jKjLjMjÙjO}rÉ'(jQ]jR]jS]jT]jV]ujXM±jYhjD]rÊ'(jy)rË'}rÌ'(jIX{An extra directory to search for frameworks (OS X only). You can use this flag multiple times to get a list of directories.rÍ'jJjÇ'jKjLjMj|jO}rÎ'(jQ]jR]jS]jT]jV]ujXM¥jYhjD]rÏ'jbX{An extra directory to search for frameworks (OS X only). You can use this flag multiple times to get a list of directories.rÐ'…rÑ'}rÒ'(jIjÍ'jKNjXNjYhjJjË'ubaubjy)rÓ'}rÔ'(jIXOYou 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.jJjÇ'jKjLjMj|jO}rÕ'(jQ]jR]jS]jT]jV]ujXM¨jYhjD]rÖ'(jbXŠ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Ù'(jIXˆ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 jKNjXNjYhjJjÓ'ubj‚)rÚ'}rÛ'(jIX ``.cabal``jO}rÜ'(jQ]jR]jS]jT]jV]ujJjÓ'jD]rÝ'jbX.cabalrÞ'…rß'}rà'(jIUjJjÚ'ubajMjŠubjbXH file. Using this option has the same affect as appending the directory rá'…râ'}rã'(jIXH file. Using this option has the same affect as appending the directory jKNjXNjYhjJjÓ'ubj½)rä'}rå'(jIX*dir*jO}ræ'(jQ]jR]jS]jT]jV]ujJjÓ'jD]rç'jbXdirrè'…ré'}rê'(jIUjJjä'ubajMjÅubjbX to the rë'…rì'}rí'(jIX to the jKNjXNjYhjJjÓ'ubj‚)rî'}rï'(jIX``extra-lib-dirs``jO}rð'(jQ]jR]jS]jT]jV]ujJjÓ'jD]rñ'jbXextra-lib-dirsrò'…ró'}rô'(jIUjJjî'ubajMjŠubjbX9 field in each library and executable in the package’s rõ'…rö'}r÷'(jIX7 field in each library and executable in the package's jKNjXNjYhjJjÓ'ubj‚)rø'}rù'(jIX ``.cabal``jO}rú'(jQ]jR]jS]jT]jV]ujJjÓ'jD]rû'jbX.cabalrü'…rý'}rþ'(jIUjJjø'ubajMjŠubjbX 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((jIX 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.jKNjXNjYhjJjÓ'ubeubeubeubj’)r(}r((jIUjJjojKjLjMj•jO}r((jT]jS]jQ]jR]jV]Uentries]r((j˜X@setup-configure command line option; --dependency[=pkgname=ipid]hÔUNtr(aujXNjYhjD]ubjš)r(}r((jIUjJjojKjLjMjjO}r ((jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr (j£j (ujXNjYhjD]r ((j¥)r (}r ((jIX--dependency[=pkgname=ipid]jJj(jKjLjMj¨jO}r((jª]r(X --dependency[r(ajT]r(hÔajS]jQ]jR]jV]r(h-aj°‰ujXM·jYhjD]r((j²)r(}r((jIj(jJj (jKjLjMjµjO}r((j½j¾jT]jS]jQ]jR]jV]ujXM·jYhjD]r(jbX --dependency[r(…r(}r((jIUjKNjXNjYhjJj(ubaubj»)r(}r((jIX=pkgname=ipid]jJj (jKjLjMj¾jO}r((j½j¾jT]jS]jQ]jR]jV]ujXM·jYhjD]r(jbX=pkgname=ipid]r(…r (}r!((jIUjKNjXNjYhjJj(ubaubeubjÖ)r"(}r#((jIUjJj(jKjLjMjÙjO}r$((jQ]jR]jS]jT]jV]ujXM·jYhjD]r%(jy)r&(}r'((jIX¿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*.jJj"(jKjLjMj|jO}r(((jQ]jR]jS]jT]jV]ujXM´jYhjD]r)((jbXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to r*(…r+(}r,((jIXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to jKNjXNjYhjJj&(ubj½)r-(}r.((jIX *pkgname*jO}r/((jQ]jR]jS]jT]jV]ujJj&(jD]r0(jbXpkgnamer1(…r2(}r3((jIUjJj-(ubajMjÅubjbX in a r4(…r5(}r6((jIX in a jKNjXNjYhjJj&(ubj‚)r7(}r8((jIX``build-depends``jO}r9((jQ]jR]jS]jT]jV]ujJj&(jD]r:(jbX build-dependsr;(…r<(}r=((jIUjJj7(ubajMjŠubjbX should be resolved to r>(…r?(}r@((jIX should be resolved to jKNjXNjYhjJj&(ubj½)rA(}rB((jIX*ipid*jO}rC((jQ]jR]jS]jT]jV]ujJj&(jD]rD(jbXipidrE(…rF(}rG((jIUjJjA(ubajMjÅubjbX.…rH(}rI((jIX.jKNjXNjYhjJj&(ubeubaubeubj’)rJ(}rK((jIUjJjojKjLjMj•jO}rL((jT]jS]jQ]jR]jV]Uentries]rM((j˜X:setup-configure command line option; --exact-configurationj/UNtrN(aujXNjYhjD]ubjš)rO(}rP((jIUjJjojKjLjMjjO}rQ((jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrR(j£jR(ujXNjYhjD]rS((j¥)rT(}rU((jIX--exact-configurationrV(jJjO(jKjLjMj¨jO}rW((jª]rX(jV(ajT]rY(j/ajS]jQ]jR]jV]rZ(hŽaj°‰ujXM¿jYhjD]r[((j²)r\(}r]((jIjV(jJjT(jKjLjMjµjO}r^((j½j¾jT]jS]jQ]jR]jV]ujXM¿jYhjD]r_(jbX--exact-configurationr`(…ra(}rb((jIUjKNjXNjYhjJj\(ubaubj»)rc(}rd((jIUjJjT(jKjLjMj¾jO}re((j½j¾jT]jS]jQ]jR]jV]ujXM¿jYhjD]ubeubjÖ)rf(}rg((jIUjJjO(jKjLjMjÙjO}rh((jQ]jR]jS]jT]jV]ujXM¿jYhjD]ri(jy)rj(}rk((jIX$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.jJjf(jKjLjMj|jO}rl((jQ]jR]jS]jT]jV]ujXMºjYhjD]rm((jbXMThis changes Cabal to require every dependency be explicitly specified using rn(…ro(}rp((jIXMThis changes Cabal to require every dependency be explicitly specified using jKNjXNjYhjJjj(ubj­)rq(}rr((jIX:option:`--dependency`rs(jJjj(jKjLjMj±jO}rt((UreftypeXoptionj³ˆj´X --dependencyU refdomainXstdru(jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMºjD]rv(j‚)rw(}rx((jIjs(jO}ry((jQ]jR]rz((j¾ju(X std-optionr{(ejS]jT]jV]ujJjq(jD]r|(jbX --dependencyr}(…r~(}r((jIUjJjw(ubajMjŠubaubjbXª, 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‚((jIX¤, 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 jKNjXNjYhjJjj(ubj­)rƒ(}r„((jIX:option:`--dependency`r…(jJjj(jKjLjMj±jO}r†((UreftypeXoptionj³ˆj´X --dependencyU refdomainXstdr‡(jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMºjD]rˆ(j‚)r‰(}rŠ((jIj…(jO}r‹((jQ]jR]rŒ((j¾j‡(X std-optionr(ejS]jT]jV]ujJjƒ(jD]rŽ(jbX --dependencyr(…r(}r‘((jIUjJj‰(ubajMjŠubaubjbX flags.r’(…r“(}r”((jIX flags.jKNjXNjYhjJjj(ubeubaubeubj’)r•(}r–((jIUjJjojKjLjMj•jO}r—((jT]jS]jQ]jR]jV]Uentries]r˜((j˜XOsetup-configure command line option; --allow-newer[=pkgs], --allow-older[=pkgs]hßUNtr™(aujXNjYhjD]ubjš)rš(}r›((jIUjJjojKjLjMjjO}rœ((jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr(j£j(ujXNjYhjD]rž((j¥)rŸ(}r ((jIX*--allow-newer[=pkgs], --allow-older[=pkgs]jJjš(jKjLjMj¨jO}r¡((jª]r¢((X--allow-newer[r£(X--allow-older[r¤(ejT]r¥(hßajS]jQ]jR]jV]r¦((h8h‚ej°‰ujXMjYhjD]r§((j²)r¨(}r©((jIj£(jJjŸ(jKjLjMjµjO}rª((j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r«(jbX--allow-newer[r¬(…r­(}r®((jIUjKNjXNjYhjJj¨(ubaubj»)r¯(}r°((jIX=pkgs]jJjŸ(jKjLjMj¾jO}r±((j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r²(jbX=pkgs]r³(…r´(}rµ((jIUjKNjXNjYhjJj¯(ubaubj»)r¶(}r·((jIjÂjJjŸ(jKjLjMj¾jO}r¸((j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r¹(jbX, rº(…r»(}r¼((jIUjKNjXNjYhjJj¶(ubaubj²)r½(}r¾((jIj¤(jJjŸ(jKjLjMjµjO}r¿((j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÀ(jbX--allow-older[rÁ(…rÂ(}rÃ((jIUjKNjXNjYhjJj½(ubaubj»)rÄ(}rÅ((jIX=pkgs]jJjŸ(jKjLjMj¾jO}rÆ((j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rÇ(jbX=pkgs]rÈ(…rÉ(}rÊ((jIUjKNjXNjYhjJjÄ(ubaubeubjÖ)rË(}rÌ((jIUjJjš(jKjLjMjÙjO}rÍ((jQ]jR]jS]jT]jV]ujXMjYhjD]rÎ((jy)rÏ(}rÐ((jIXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rÑ(jJjË(jKjLjMj|jO}rÒ((jQ]jR]jS]jT]jV]ujXMÂjYhjD]rÓ(jbXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rÔ(…rÕ(}rÖ((jIjÑ(jKNjXNjYhjJjÏ(ubaubjy)r×(}rØ((jIXî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.jJjË(jKjLjMj|jO}rÙ((jQ]jR]jS]jT]jV]ujXMÅjYhjD]rÚ((jbX:The following description focuses on upper bounds and the rÛ(…rÜ(}rÝ((jIX:The following description focuses on upper bounds and the jKNjXNjYhjJj×(ubj­)rÞ(}rß((jIX:option:`--allow-newer`rà(jJj×(jKjLjMj±jO}rá((UreftypeXoptionj³ˆj´X --allow-newerU refdomainXstdrâ(jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÅjD]rã(j‚)rä(}rå((jIjà(jO}ræ((jQ]jR]rç((j¾jâ(X std-optionrè(ejS]jT]jV]ujJjÞ(jD]ré(jbX --allow-newerrê(…rë(}rì((jIUjJjä(ubajMjŠubaubjbX" flag, but applies analogously to rí(…rî(}rï((jIX" flag, but applies analogously to jKNjXNjYhjJj×(ubj­)rð(}rñ((jIX:option:`--allow-older`rò(jJj×(jKjLjMj±jO}ró((UreftypeXoptionj³ˆj´X --allow-olderU refdomainXstdrô(jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÅjD]rõ(j‚)rö(}r÷((jIjò(jO}rø((jQ]jR]rù((j¾jô(X std-optionrú(ejS]jT]jV]ujJjð(jD]rû(jbX --allow-olderrü(…rý(}rþ((jIUjJjö(ubajMjŠubaubjbX and lower bounds. rÿ(…r)}r)(jIX and lower bounds. jKNjXNjYhjJj×(ubj­)r)}r)(jIX:option:`--allow-newer`r)jJj×(jKjLjMj±jO}r)(UreftypeXoptionj³ˆj´X --allow-newerU refdomainXstdr)jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÅjD]r)j‚)r)}r )(jIj)jO}r )(jQ]jR]r )(j¾j)X std-optionr )ejS]jT]jV]ujJj)jD]r )jbX --allow-newerr)…r)}r)(jIUjJj)ubajMjŠubaubjbX and r)…r)}r)(jIX and jKNjXNjYhjJj×(ubj­)r)}r)(jIX:option:`--allow-older`r)jJj×(jKjLjMj±jO}r)(UreftypeXoptionj³ˆj´X --allow-olderU refdomainXstdr)jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMÅjD]r)j‚)r)}r)(jIj)jO}r)(jQ]jR]r)(j¾j)X std-optionr)ejS]jT]jV]ujJj)jD]r)jbX --allow-olderr )…r!)}r")(jIUjJj)ubajMjŠubaubjbX can be used at the same time.r#)…r$)}r%)(jIX can be used at the same time.jKNjXNjYhjJj×(ubeubjy)r&)}r')(jIXJIf 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.jJjË(jKjLjMj|jO}r()(jQ]jR]jS]jT]jV]ujXMÊjYhjD]r))(jbXœ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,)(jIXœ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 jKNjXNjYhjJj&)ubj‚)r-)}r.)(jIX#``cabal install --allow-newer=B A``jO}r/)(jQ]jR]jS]jT]jV]ujJj&)jD]r0)jbXcabal install --allow-newer=B Ar1)…r2)}r3)(jIUjJj-)ubajMjŠubjbX. 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.r4)…r5)}r6)(jIX‹. 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.jKNjXNjYhjJj&)ubeubjy)r7)}r8)(jIXExample:r9)jJjË(jKjLjMj|jO}r:)(jQ]jR]jS]jT]jV]ujXMÐjYhjD]r;)jbXExample:r<)…r=)}r>)(jIj9)jKNjXNjYhjJj7)ubaubj¶)r?)}r@)(jIX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...jJjË(jKjLjMj¹jO}rA)(j½j¾jT]jS]jQ]jR]jV]ujXMÔjYhjD]rB)jbX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...rC)…rD)}rE)(jIUjJj?)ubaubjy)rF)}rG)(jIXAdditional examples:rH)jJjË(jKjLjMj|jO}rI)(jQ]jR]jS]jT]jV]ujXMÝjYhjD]rJ)jbXAdditional examples:rK)…rL)}rM)(jIjH)jKNjXNjYhjJjF)ubaubj¶)rN)}rO)(jIX-# 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" foojJjË(jKjLjMj¹jO}rP)(j½j¾jT]jS]jQ]jR]jV]ujXMájYhjD]rQ)jbX-# 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" foorR)…rS)}rT)(jIUjJjN)ubaubjy)rU)}rV)(jIXÚ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``.jJjË(jKjLjMj|jO}rW)(jQ]jR]jS]jT]jV]ujXMêjYhjD]rX)(jbX+It’s also possible to limit the scope of rY)…rZ)}r[)(jIX)It's also possible to limit the scope of jKNjXNjYhjJjU)ubj­)r\)}r])(jIX:option:`--allow-newer`r^)jJjU)jKjLjMj±jO}r_)(UreftypeXoptionj³ˆj´X --allow-newerU refdomainXstdr`)jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMêjD]ra)j‚)rb)}rc)(jIj^)jO}rd)(jQ]jR]re)(j¾j`)X std-optionrf)ejS]jT]jV]ujJj\)jD]rg)jbX --allow-newerrh)…ri)}rj)(jIUjJjb)ubajMjŠubaubjbX to single packages with the rk)…rl)}rm)(jIX to single packages with the jKNjXNjYhjJjU)ubj‚)rn)}ro)(jIX``--allow-newer=scope:dep``jO}rp)(jQ]jR]jS]jT]jV]ujJjU)jD]rq)jbX--allow-newer=scope:deprr)…rs)}rt)(jIUjJjn)ubajMjŠubjbX+ syntax. This means that the dependency on ru)…rv)}rw)(jIX+ syntax. This means that the dependency on jKNjXNjYhjJjU)ubj‚)rx)}ry)(jIX``dep``jO}rz)(jQ]jR]jS]jT]jV]ujJjU)jD]r{)jbXdepr|)…r})}r~)(jIUjJjx)ubajMjŠubjbX& will be relaxed only for the package r)…r€)}r)(jIX& will be relaxed only for the package jKNjXNjYhjJjU)ubj‚)r‚)}rƒ)(jIX ``scope``jO}r„)(jQ]jR]jS]jT]jV]ujJjU)jD]r…)jbXscoper†)…r‡)}rˆ)(jIUjJj‚)ubajMjŠubjbX.…r‰)}rŠ)(jIX.jKNjXNjYhjJjU)ubeubjy)r‹)}rŒ)(jIXExample:r)jJjË(jKjLjMj|jO}rŽ)(jQ]jR]jS]jT]jV]ujXMïjYhjD]r)jbXExample:r)…r‘)}r’)(jIj)jKNjXNjYhjJj‹)ubaubj¶)r“)}r”)(jIX‚# 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:timejJjË(jKjLjMj¹jO}r•)(j½j¾jT]jS]jQ]jR]jV]ujXMójYhjD]r–)jbX‚# 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™)(jIUjJj“)ubaubjy)rš)}r›)(jIXì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``).jJjË(jKjLjMj|jO}rœ)(jQ]jR]jS]jT]jV]ujXMüjYhjD]r)(jbXFinally, one can enable rž)…rŸ)}r )(jIXFinally, one can enable jKNjXNjYhjJjš)ubj­)r¡)}r¢)(jIX:option:`--allow-newer`r£)jJjš)jKjLjMj±jO}r¤)(UreftypeXoptionj³ˆj´X --allow-newerU refdomainXstdr¥)jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸j¯ujXMüjD]r¦)j‚)r§)}r¨)(jIj£)jO}r©)(jQ]jR]rª)(j¾j¥)X std-optionr«)ejS]jT]jV]ujJj¡)jD]r¬)jbX --allow-newerr­)…r®)}r¯)(jIUjJj§)ubajMjŠubaubjbX permanently by setting r°)…r±)}r²)(jIX permanently by setting jKNjXNjYhjJjš)ubj‚)r³)}r´)(jIX``allow-newer: True``jO}rµ)(jQ]jR]jS]jT]jV]ujJjš)jD]r¶)jbXallow-newer: Truer·)…r¸)}r¹)(jIUjJj³)ubajMjŠubjbX in the rº)…r»)}r¼)(jIX in the jKNjXNjYhjJjš)ubj‚)r½)}r¾)(jIX``~/.cabal/config``jO}r¿)(jQ]jR]jS]jT]jV]ujJjš)jD]rÀ)jbX~/.cabal/configrÁ)…rÂ)}rÃ)(jIUjJj½)ubajMjŠubjbXT file. Enabling ‘allow-newer’ selectively is also supported in the config file (rÄ)…rÅ)}rÆ)(jIXP file. Enabling 'allow-newer' selectively is also supported in the config file (jKNjXNjYhjJjš)ubj‚)rÇ)}rÈ)(jIX#``allow-newer: foo, bar, baz:base``jO}rÉ)(jQ]jR]jS]jT]jV]ujJjš)jD]rÊ)jbXallow-newer: foo, bar, baz:baserË)…rÌ)}rÍ)(jIUjJjÇ)ubajMjŠubjbX).rÎ)…rÏ)}rÐ)(jIX).jKNjXNjYhjJjš)ubeubeubeubj’)rÑ)}rÒ)(jIUjJjojKNjMj•jO}rÓ)(jT]jS]jQ]jR]jV]Uentries]rÔ)(j˜X<setup-configure command line option; --constraint=constrainthÅUNtrÕ)aujXNjYhjD]ubjš)rÖ)}r×)(jIUjJjojKNjMjjO}rØ)(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÙ)j£jÙ)ujXNjYhjD]rÚ)(j¥)rÛ)}rÜ)(jIX--constraint=constraintjJjÖ)jKjLjMj¨jO}rÝ)(jª]rÞ)X --constraintrß)ajT]rà)hÅajS]jQ]jR]jV]rá)haj°‰ujXMUjYhjD]râ)(j²)rã)}rä)(jIjß)jJjÛ)jKjLjMjµjO}rå)(j½j¾jT]jS]jQ]jR]jV]ujXMUjYhjD]ræ)jbX --constraintrç)…rè)}ré)(jIUjKNjXNjYhjJjã)ubaubj»)rê)}rë)(jIX =constraintjJjÛ)jKjLjMj¾jO}rì)(j½j¾jT]jS]jQ]jR]jV]ujXMUjYhjD]rí)jbX =constraintrî)…rï)}rð)(jIUjKNjXNjYhjJjê)ubaubeubjÖ)rñ)}rò)(jIUjJjÖ)jKjLjMjÙjO}ró)(jQ]jR]jS]jT]jV]ujXMUjYhjD]rô)(jy)rõ)}rö)(jIXÕ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:jJjñ)jKjLjMj|jO}r÷)(jQ]jR]jS]jT]jV]ujXMjYhjD]rø)(jbX©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û)(jIX©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 jKNjXNjYhjJjõ)ubj‚)rü)}rý)(jIX``bar``jO}rþ)(jQ]jR]jS]jT]jV]ujJjõ)jD]rÿ)jbXbarr*…r*}r*(jIUjJjü)ubajMjŠubjbX or do not use r*…r*}r*(jIX or do not use jKNjXNjYhjJjõ)ubj‚)r*}r*(jIX``bar``jO}r*(jQ]jR]jS]jT]jV]ujJjõ)jD]r *jbXbarr *…r *}r *(jIUjJj*ubajMjŠubjbX at all, write:r *…r*}r*(jIX at all, write:jKNjXNjYhjJjõ)ubeubj¶)r*}r*(jIX)$ cabal install --constraint="bar == 2.1"jJjñ)jKjLjMj¹jO}r*(j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]r*jbX)$ cabal install --constraint="bar == 2.1"r*…r*}r*(jIUjJj*ubaubjy)r*}r*(jIXƒVersion bounds have the same syntax as ``build-depends``. As a special case, the following prevents ``bar`` from being used at all:jJjñ)jKjLjMj|jO}r*(jQ]jR]jS]jT]jV]ujXM jYhjD]r*(jbX'Version bounds have the same syntax as r*…r*}r*(jIX'Version bounds have the same syntax as jKNjXNjYhjJj*ubj‚)r*}r*(jIX``build-depends``jO}r *(jQ]jR]jS]jT]jV]ujJj*jD]r!*jbX build-dependsr"*…r#*}r$*(jIUjJj*ubajMjŠubjbX,. As a special case, the following prevents r%*…r&*}r'*(jIX,. As a special case, the following prevents jKNjXNjYhjJj*ubj‚)r(*}r)*(jIX``bar``jO}r**(jQ]jR]jS]jT]jV]ujJj*jD]r+*jbXbarr,*…r-*}r.*(jIUjJj(*ubajMjŠubjbX from being used at all:r/*…r0*}r1*(jIX from being used at all:jKNjXNjYhjJj*ubeubj¶)r2*}r3*(jIX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"jJjñ)jKjLjMj¹jO}r4*(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r5*jbX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"r6*…r7*}r8*(jIUjJj2*ubaubjy)r9*}r:*(jIX&You can also specify flag assignments:r;*jJjñ)jKjLjMj|jO}r<*(jQ]jR]jS]jT]jV]ujXMjYhjD]r=*jbX&You can also specify flag assignments:r>*…r?*}r@*(jIj;*jKNjXNjYhjJj9*ubaubj¶)rA*}rB*(jIX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"jJjñ)jKjLjMj¹jO}rC*(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rD*jbX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"rE*…rF*}rG*(jIUjJjA*ubaubjy)rH*}rI*(jIXWTo specify multiple constraints, you may pass the ``constraint`` option multiple times.jJjñ)jKjLjMj|jO}rJ*(jQ]jR]jS]jT]jV]ujXMjYhjD]rK*(jbX2To specify multiple constraints, you may pass the rL*…rM*}rN*(jIX2To specify multiple constraints, you may pass the jKNjXNjYhjJjH*ubj‚)rO*}rP*(jIX``constraint``jO}rQ*(jQ]jR]jS]jT]jV]ujJjH*jD]rR*jbX constraintrS*…rT*}rU*(jIUjJjO*ubajMjŠubjbX option multiple times.rV*…rW*}rX*(jIX option multiple times.jKNjXNjYhjJjH*ubeubjy)rY*}rZ*(jIXYThere are also some more specialized constraints, which most people don't generally need:r[*jJjñ)jKjLjMj|jO}r\*(jQ]jR]jS]jT]jV]ujXM!jYhjD]r]*jbX[There are also some more specialized constraints, which most people don’t generally need:r^*…r_*}r`*(jIj[*jKNjXNjYhjJjY*ubaubj¶)ra*}rb*(jIXö# 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"jJjñ)jKjLjMj¹jO}rc*(j½j¾jT]jS]jQ]jR]jV]ujXM&jYhjD]rd*jbXö# 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"re*…rf*}rg*(jIUjJja*ubaubjy)rh*}ri*(jIXÌ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:jJjñ)jKjLjMj|jO}rj*(jQ]jR]jS]jT]jV]ujXM3jYhjD]rk*(jbX:By default, constraints only apply to build dependencies (rl*…rm*}rn*(jIX:By default, constraints only apply to build dependencies (jKNjXNjYhjJjh*ubj‚)ro*}rp*(jIX``build-depends``jO}rq*(jQ]jR]jS]jT]jV]ujJjh*jD]rr*jbX build-dependsrs*…rt*}ru*(jIUjJjo*ubajMjŠubjbXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the rv*…rw*}rx*(jIXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the jKNjXNjYhjJjh*ubj‚)ry*}rz*(jIX ``Setup.hs``jO}r{*(jQ]jR]jS]jT]jV]ujJjh*jD]r|*jbXSetup.hsr}*…r~*}r*(jIUjJjy*ubajMjŠubjbX script of any package (r€*…r*}r‚*(jIX script of any package (jKNjXNjYhjJjh*ubj‚)rƒ*}r„*(jIX``setup-depends``jO}r…*(jQ]jR]jS]jT]jV]ujJjh*jD]r†*jbX setup-dependsr‡*…rˆ*}r‰*(jIUjJjƒ*ubajMjŠubjbX$) nor do they apply to build tools (rŠ*…r‹*}rŒ*(jIX$) nor do they apply to build tools (jKNjXNjYhjJjh*ubj‚)r*}rŽ*(jIX``build-tool-depends``jO}r*(jQ]jR]jS]jT]jV]ujJjh*jD]r*jbXbuild-tool-dependsr‘*…r’*}r“*(jIUjJj*ubajMjŠubjbX¡) 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–*(jIX¡) 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:jKNjXNjYhjJjh*ubeubj¶)r—*}r˜*(jIXž# Example use of the 'any' qualifier. This constraint # applies to package bar anywhere in the dependency graph. $ cabal install --constraint="any.bar == 1.0"jJjñ)jKjLjMj¹jO}r™*(j½j¾jT]jS]jQ]jR]jV]ujXM?jYhjD]rš*jbXž# 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*(jIUjJj—*ubaubj¶)rž*}rŸ*(jIXP# 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"jJjñ)jKjLjMj¹jO}r *(j½j¾jT]jS]jQ]jR]jV]ujXMEjYhjD]r¡*jbXP# 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¤*(jIUjJjž*ubaubcdocutils.nodes comment r¥*)r¦*}r§*(jIXBTODO: Uncomment this example once we decide on a syntax for 'exe'.jJjñ)jKjLjMUcommentr¨*jO}r©*(j½j¾jT]jS]jQ]jR]jV]ujXMOjYhjD]rª*jbXBTODO: Uncomment this example once we decide on a syntax for 'exe'.r«*…r¬*}r­*(jIUjJj¦*ubaubj¥*)r®*}r¯*(jIXï# 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"jJjñ)jKjLjMj¨*jO}r°*(j½j¾jT]jS]jQ]jR]jV]ujXMTjYhjD]r±*jbXï# 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"r²*…r³*}r´*(jIUjJj®*ubaubeubeubj’)rµ*}r¶*(jIUjJjojKjLjMj•jO}r·*(jT]jS]jQ]jR]jV]Uentries]r¸*(j˜X<setup-configure command line option; --preference=preferencehïUNtr¹*aujXNjYhjD]ubjš)rº*}r»*(jIUjJjojKjLjMjjO}r¼*(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr½*j£j½*ujXNjYhjD]r¾*(j¥)r¿*}rÀ*(jIX--preference=preferencejJjº*jKjLjMj¨jO}rÁ*(jª]rÂ*X --preferencerÃ*ajT]rÄ*hïajS]jQ]jR]jV]rÅ*hIaj°‰ujXMZjYhjD]rÆ*(j²)rÇ*}rÈ*(jIjÃ*jJj¿*jKjLjMjµjO}rÉ*(j½j¾jT]jS]jQ]jR]jV]ujXMZjYhjD]rÊ*jbX --preferencerË*…rÌ*}rÍ*(jIUjKNjXNjYhjJjÇ*ubaubj»)rÎ*}rÏ*(jIX =preferencejJj¿*jKjLjMj¾jO}rÐ*(j½j¾jT]jS]jQ]jR]jV]ujXMZjYhjD]rÑ*jbX =preferencerÒ*…rÓ*}rÔ*(jIUjKNjXNjYhjJjÎ*ubaubeubjÖ)rÕ*}rÖ*(jIUjJjº*jKjLjMjÙjO}r×*(jQ]jR]jS]jT]jV]ujXMZjYhjD]rØ*jy)rÙ*}rÚ*(jIX‚Specify a soft constraint on versions of a package. The solver will attempt to satisfy these preferences on a "best-effort" basis.rÛ*jJjÕ*jKjLjMj|jO}rÜ*(jQ]jR]jS]jT]jV]ujXMXjYhjD]rÝ*jbX†Specify a soft constraint on versions of a package. The solver will attempt to satisfy these preferences on a “best-effort†basis.rÞ*…rß*}rà*(jIjÛ*jKNjXNjYhjJjÙ*ubaubaubeubj’)rá*}râ*(jIUjJjojKjLjMj•jO}rã*(jT]jS]jQ]jR]jV]Uentries]rä*(j˜X=setup-configure command line option; --disable-response-filesh®UNtrå*aujXNjYhjD]ubjš)ræ*}rç*(jIUjJjojKjLjMjjO}rè*(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionré*j£jé*ujXNjYhjD]rê*(j¥)rë*}rì*(jIX--disable-response-filesrí*jJjæ*jKjLjMj¨jO}rî*(jª]rï*jí*ajT]rð*h®ajS]jQ]jR]jV]rñ*haj°‰ujXMcjYhjD]rò*(j²)ró*}rô*(jIjí*jJjë*jKjLjMjµjO}rõ*(j½j¾jT]jS]jQ]jR]jV]ujXMcjYhjD]rö*jbX--disable-response-filesr÷*…rø*}rù*(jIUjKNjXNjYhjJjó*ubaubj»)rú*}rû*(jIUjJjë*jKjLjMj¾jO}rü*(j½j¾jT]jS]jQ]jR]jV]ujXMcjYhjD]ubeubjÖ)rý*}rþ*(jIUjJjæ*jKjLjMjÙjO}rÿ*(jQ]jR]jS]jT]jV]ujXMcjYhjD]r+jy)r+}r+(jIXhEnable workaround for older versions of programs such as ``ar`` or ``ld`` that do not support response file arguments (i.e. ``@file`` arguments). You may want this flag only if you specify custom ar executable. For system ``ar`` or the one bundled with ``ghc`` on Windows the ``cabal`` should do the right thing and hence should normally not require this flag.jJjý*jKjLjMj|jO}r+(jQ]jR]jS]jT]jV]ujXM]jYhjD]r+(jbX9Enable workaround for older versions of programs such as r+…r+}r+(jIX9Enable workaround for older versions of programs such as jKNjXNjYhjJj+ubj‚)r+}r +(jIX``ar``jO}r +(jQ]jR]jS]jT]jV]ujJj+jD]r +jbXarr +…r +}r+(jIUjJj+ubajMjŠubjbX or r+…r+}r+(jIX or jKNjXNjYhjJj+ubj‚)r+}r+(jIX``ld``jO}r+(jQ]jR]jS]jT]jV]ujJj+jD]r+jbXldr+…r+}r+(jIUjJj+ubajMjŠubjbX3 that do not support response file arguments (i.e. r+…r+}r+(jIX3 that do not support response file arguments (i.e. jKNjXNjYhjJj+ubj‚)r+}r+(jIX ``@file``jO}r+(jQ]jR]jS]jT]jV]ujJj+jD]r+jbX@filer +…r!+}r"+(jIUjJj+ubajMjŠubjbXY arguments). You may want this flag only if you specify custom ar executable. For system r#+…r$+}r%+(jIXY arguments). You may want this flag only if you specify custom ar executable. For system jKNjXNjYhjJj+ubj‚)r&+}r'+(jIX``ar``jO}r(+(jQ]jR]jS]jT]jV]ujJj+jD]r)+jbXarr*+…r++}r,+(jIUjJj&+ubajMjŠubjbX or the one bundled with r-+…r.+}r/+(jIX or the one bundled with jKNjXNjYhjJj+ubj‚)r0+}r1+(jIX``ghc``jO}r2+(jQ]jR]jS]jT]jV]ujJj+jD]r3+jbXghcr4+…r5+}r6+(jIUjJj0+ubajMjŠubjbX on Windows the r7+…r8+}r9+(jIX on Windows the jKNjXNjYhjJj+ubj‚)r:+}r;+(jIX ``cabal``jO}r<+(jQ]jR]jS]jT]jV]ujJj+jD]r=+jbXcabalr>+…r?+}r@+(jIUjJj:+ubajMjŠubjbXK should do the right thing and hence should normally not require this flag.rA+…rB+}rC+(jIXK should do the right thing and hence should normally not require this flag.jKNjXNjYhjJj+ubeubaubeubjá)rD+}rE+(jIX.. _setup-build:jJjojKjLjMjäjO}rF+(jT]jS]jQ]jR]jV]jæhÈujXMdjYhjD]ubeubeubjF)rG+}rH+(jIUjJjçjKjLjé}rI+h!jD+sjMjNjO}rJ+(jQ]jR]jS]jT]rK+(hÈj;ejV]rL+(h›h!eujXMgjYhjî}rM+hÈjD+sjD]rN+(j[)rO+}rP+(jIX setup buildrQ+jJjG+jKjLjMj_jO}rR+(jQ]jR]jS]jT]jV]ujXMgjYhjD]rS+jbX setup buildrT+…rU+}rV+(jIjQ+jKNjXNjYhjJjO+ubaubjy)rW+}rX+(jIX\Perform any preprocessing or compilation needed to make this package ready for installation.rY+jJjG+jKjLjMj|jO}rZ+(jQ]jR]jS]jT]jV]ujXMijYhjD]r[+jbX\Perform any preprocessing or compilation needed to make this package ready for installation.r\+…r]+}r^+(jIjY+jKNjXNjYhjJjW+ubaubjy)r_+}r`+(jIX)This command takes the following options:ra+jJjG+jKjLjMj|jO}rb+(jQ]jR]jS]jT]jV]ujXMljYhjD]rc+jbX)This command takes the following options:rd+…re+}rf+(jIja+jKNjXNjYhjJj_+ubaubj’)rg+}rh+(jIUjJjG+jKjLjMj•jO}ri+(jT]jS]jQ]jR]jV]Uentries]rj+(j˜XMsetup-build command line option; --prog-options=options, --prog-option=optionh·UNtrk+aujXNjYhjD]ubjš)rl+}rm+(jIUjJjG+jKjLjMjjO}rn+(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionro+j£jo+ujXNjYhjD]rp+(j¥)rq+}rr+(jIX,--prog-options=options, --prog-option=optionjJjl+jKjLjMj¨jO}rs+(jª]rt+(X--prog-optionsru+X --prog-optionrv+ejT]rw+h·ajS]jQ]jR]jV]rx+(hthej°‰ujXMxjYhjD]ry+(j²)rz+}r{+(jIju+jJjq+jKjLjMjµjO}r|+(j½j¾jT]jS]jQ]jR]jV]ujXMxjYhjD]r}+jbX--prog-optionsr~+…r+}r€+(jIUjKNjXNjYhjJjz+ubaubj»)r+}r‚+(jIX=optionsjJjq+jKjLjMj¾jO}rƒ+(j½j¾jT]jS]jQ]jR]jV]ujXMxjYhjD]r„+jbX=optionsr…+…r†+}r‡+(jIUjKNjXNjYhjJj+ubaubj»)rˆ+}r‰+(jIjÂjJjq+jKjLjMj¾jO}rŠ+(j½j¾jT]jS]jQ]jR]jV]ujXMxjYhjD]r‹+jbX, rŒ+…r+}rŽ+(jIUjKNjXNjYhjJjˆ+ubaubj²)r+}r+(jIjv+jJjq+jKjLjMjµjO}r‘+(j½j¾jT]jS]jQ]jR]jV]ujXMxjYhjD]r’+jbX --prog-optionr“+…r”+}r•+(jIUjKNjXNjYhjJj+ubaubj»)r–+}r—+(jIX=optionjJjq+jKjLjMj¾jO}r˜+(j½j¾jT]jS]jQ]jR]jV]ujXMxjYhjD]r™+jbX=optionrš+…r›+}rœ+(jIUjKNjXNjYhjJj–+ubaubeubjÖ)r+}rž+(jIUjJjl+jKjLjMjÙjO}rŸ+(jQ]jR]jS]jT]jV]ujXMxjYhjD]r +jy)r¡+}r¢+(jIXiThese 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.jJj+jKjLjMj|jO}r£+(jQ]jR]jS]jT]jV]ujXMrjYhjD]r¤+(jbX!These are mostly the same as the r¥+…r¦+}r§+(jIX!These are mostly the same as the jKNjXNjYhjJj¡+ubjœ)r¨+}r©+(jIX-`options configure step <#setup-configure>`__jO}rª+(UnameXoptions configure stepjêX#setup-configurejT]jS]jQ]jR]jV]ujJj¡+jD]r«+jbXoptions configure stepr¬+…r­+}r®+(jIUjJj¨+ubajMj¥ubjbX. 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±+(jIX. 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.jKNjXNjYhjJj¡+ubeubaubeubjá)r²+}r³+(jIX.. _setup-haddock:jJjG+jKjLjMjäjO}r´+(jT]jS]jQ]jR]jV]jæhµujXMyjYhjD]ubeubjF)rµ+}r¶+(jIUjJjçjKjLjé}r·+hj²+sjMjNjO}r¸+(jQ]jR]jS]jT]r¹+(hµj1ejV]rº+(h‘heujXM|jYhjî}r»+hµj²+sjD]r¼+(j[)r½+}r¾+(jIX setup haddockr¿+jJjµ+jKjLjMj_jO}rÀ+(jQ]jR]jS]jT]jV]ujXM|jYhjD]rÁ+jbX setup haddockrÂ+…rÃ+}rÄ+(jIj¿+jKNjXNjYhjJj½+ubaubjy)rÅ+}rÆ+(jIXË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).jJjµ+jKjLjMj|jO}rÇ+(jQ]jR]jS]jT]jV]ujXM€jYhjD]rÈ+(jbX.Build the documentation for the package using rÉ+…rÊ+}rË+(jIX.Build the documentation for the package using jKNjXNjYhjJjÅ+ubjœ)rÌ+}rÍ+(jIXHaddock_jèKjJjÅ+jMj¥jO}rÎ+(UnameXHaddockjêXhttp://www.haskell.org/haddock/rÏ+jT]jS]jQ]jR]jV]ujD]rÐ+jbXHaddockrÑ+…rÒ+}rÓ+(jIUjJjÌ+ubaubjbXW. By default, only the documentation for the exposed modules is generated (but see the rÔ+…rÕ+}rÖ+(jIXW. By default, only the documentation for the exposed modules is generated (but see the jKNjXNjYhjJjÅ+ubj­)r×+}rØ+(jIX:option:`--executables`rÙ+jJjÅ+jKjLjMj±jO}rÚ+(UreftypeXoptionj³ˆj´X --executablesU refdomainXstdrÛ+jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸X setup-haddockrÜ+ujXM€jD]rÝ+j‚)rÞ+}rß+(jIjÙ+jO}rà+(jQ]jR]rá+(j¾jÛ+X std-optionrâ+ejS]jT]jV]ujJj×+jD]rã+jbX --executablesrä+…rå+}ræ+(jIUjJjÞ+ubajMjŠubaubjbX and rç+…rè+}ré+(jIX and jKNjXNjYhjJjÅ+ubj­)rê+}rë+(jIX:option:`--internal`rì+jJjÅ+jKjLjMj±jO}rí+(UreftypeXoptionj³ˆj´X --internalU refdomainXstdrî+jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸jÜ+ujXM€jD]rï+j‚)rð+}rñ+(jIjì+jO}rò+(jQ]jR]ró+(j¾jî+X std-optionrô+ejS]jT]jV]ujJjê+jD]rõ+jbX --internalrö+…r÷+}rø+(jIUjJjð+ubajMjŠubaubjbX flags below).rù+…rú+}rû+(jIX flags below).jKNjXNjYhjJjÅ+ubeubjy)rü+}rý+(jIX)This command takes the following options:rþ+jJjµ+jKjLjMj|jO}rÿ+(jQ]jR]jS]jT]jV]ujXM„jYhjD]r,jbX)This command takes the following options:r,…r,}r,(jIjþ+jKNjXNjYhjJjü+ubaubj’)r,}r,(jIUjJjµ+jKjLjMj•jO}r,(jT]jS]jQ]jR]jV]Uentries]r,(j˜X+setup-haddock command line option; --hooglehÞUNtr,aujXNjYhjD]ubjš)r ,}r ,(jIUjJjµ+jKjLjMjjO}r ,(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr ,j£j ,ujXNjYhjD]r ,(j¥)r,}r,(jIX--hoogler,jJj ,jKjLjMj¨jO}r,(jª]r,j,ajT]r,hÞajS]jQ]jR]jV]r,h7aj°‰ujXMŒjYhjD]r,(j²)r,}r,(jIj,jJj,jKjLjMjµjO}r,(j½j¾jT]jS]jQ]jR]jV]ujXMŒjYhjD]r,jbX--hoogler,…r,}r,(jIUjKNjXNjYhjJj,ubaubj»)r,}r,(jIUjJj,jKjLjMj¾jO}r,(j½j¾jT]jS]jQ]jR]jV]ujXMŒjYhjD]ubeubjÖ)r ,}r!,(jIUjJj ,jKjLjMjÙjO}r",(jQ]jR]jS]jT]jV]ujXMŒjYhjD]r#,jy)r$,}r%,(jIXº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.jJj ,jKjLjMj|jO}r&,(jQ]jR]jS]jT]jV]ujXMˆjYhjD]r',(jbXGenerate a file r(,…r),}r*,(jIXGenerate a file jKNjXNjYhjJj$,ubj‚)r+,}r,,(jIX``dist/doc/html/``jO}r-,(jQ]jR]jS]jT]jV]ujJj$,jD]r.,jbXdist/doc/html/r/,…r0,}r1,(jIUjJj+,ubajMjŠubjbX…r2,}r3,(jIX\ r4,jKNjXNjYhjJj$,ubj½)r5,}r6,(jIX*pkgid*jO}r7,(jQ]jR]jS]jT]jV]ujJj$,jD]r8,jbXpkgidr9,…r:,}r;,(jIUjJj5,ubajMjÅubjbX…r<,}r=,(jIj4,jJj$,ubj‚)r>,}r?,(jIX``.txt``jO}r@,(jQ]jR]jS]jT]jV]ujJj$,jD]rA,jbX.txtrB,…rC,}rD,(jIUjJj>,ubajMjŠubjbX, which can be converted by rE,…rF,}rG,(jIX, which can be converted by jKNjXNjYhjJj$,ubjœ)rH,}rI,(jIXHoogle_jèKjJj$,jMj¥jO}rJ,(UnameXHooglejêXhttp://www.haskell.org/hoogle/rK,jT]jS]jQ]jR]jV]ujD]rL,jbXHooglerM,…rN,}rO,(jIUjJjH,ubaubjbX> into a database for searching. This is equivalent to running rP,…rQ,}rR,(jIX> into a database for searching. This is equivalent to running jKNjXNjYhjJj$,ubjœ)rS,}rT,(jIXHaddock_jèKjJj$,jMj¥jO}rU,(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]rV,jbXHaddockrW,…rX,}rY,(jIUjJjS,ubaubjbX with the rZ,…r[,}r\,(jIX with the jKNjXNjYhjJj$,ubj‚)r],}r^,(jIX ``--hoogle``jO}r_,(jQ]jR]jS]jT]jV]ujJj$,jD]r`,jbX--hooglera,…rb,}rc,(jIUjJj],ubajMjŠubjbX flag.rd,…re,}rf,(jIX flag.jKNjXNjYhjJj$,ubeubaubeubj’)rg,}rh,(jIUjJjµ+jKjLjMj•jO}ri,(jT]jS]jQ]jR]jV]Uentries]rj,(j˜X6setup-haddock command line option; --html-location=urlj!UNtrk,aujXNjYhjD]ubjš)rl,}rm,(jIUjJjµ+jKjLjMjjO}rn,(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionro,j£jo,ujXNjYhjD]rp,(j¥)rq,}rr,(jIX--html-location=urljJjl,jKjLjMj¨jO}rs,(jª]rt,X--html-locationru,ajT]rv,j!ajS]jQ]jR]jV]rw,h~aj°‰ujXMœjYhjD]rx,(j²)ry,}rz,(jIju,jJjq,jKjLjMjµjO}r{,(j½j¾jT]jS]jQ]jR]jV]ujXMœjYhjD]r|,jbX--html-locationr},…r~,}r,(jIUjKNjXNjYhjJjy,ubaubj»)r€,}r,(jIX=urljJjq,jKjLjMj¾jO}r‚,(j½j¾jT]jS]jQ]jR]jV]ujXMœjYhjD]rƒ,jbX=urlr„,…r…,}r†,(jIUjKNjXNjYhjJj€,ubaubeubjÖ)r‡,}rˆ,(jIUjJjl,jKjLjMjÙjO}r‰,(jQ]jR]jS]jT]jV]ujXMœjYhjD]rŠ,(jy)r‹,}rŒ,(jIXoSpecify 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:jJj‡,jKjLjMj|jO}r,(jQ]jR]jS]jT]jV]ujXMjYhjD]rŽ,(jbXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (r,…r,}r‘,(jIXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (jKNjXNjYhjJj‹,ubjœ)r’,}r“,(jIX3`see listing <#paths-in-the-simple-build-system>`__jO}r”,(UnameX see listingjêX!#paths-in-the-simple-build-systemjT]jS]jQ]jR]jV]ujJj‹,jD]r•,jbX see listingr–,…r—,}r˜,(jIUjJj’,ubajMj¥ubjbXÅ) 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›,(jIXÅ) 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 jKNjXNjYhjJj‹,ubjœ)rœ,}r,(jIXHackage_jèKjJj‹,jMj¥jO}rž,(UnameXHackagejêjëjT]jS]jQ]jR]jV]ujD]rŸ,jbXHackager ,…r¡,}r¢,(jIUjJjœ,ubaubjbX pages:r£,…r¤,}r¥,(jIX pages:jKNjXNjYhjJj‹,ubeubcdocutils.nodes block_quote r¦,)r§,}r¨,(jIUjJj‡,jKjLjMU block_quoter©,jO}rª,(jQ]jR]jS]jT]jV]ujXNjYhjD]r«,jy)r¬,}r­,(jIX`setup haddock --html-location='http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'jJj§,jKjLjMj|jO}r®,(jQ]jR]jS]jT]jV]ujXM–jD]r¯,(jbX"setup haddock –html-location=’r°,…r±,}r²,(jIXsetup haddock --html-location='jJj¬,ubjœ)r³,}r´,(jIX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlrµ,jO}r¶,(Urefurijµ,jT]jS]jQ]jR]jV]ujJj¬,jD]r·,jbX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlr¸,…r¹,}rº,(jIUjJj³,ubajMj¥ubjbX’…r»,}r¼,(jIX'jJj¬,ubeubaubjy)r½,}r¾,(jIX±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``).jJj‡,jKjLjMj|jO}r¿,(jQ]jR]jS]jT]jV]ujXM™jYhjD]rÀ,(jbX¤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Ã,(jIX¤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. jKNjXNjYhjJj½,ubj‚)rÄ,}rÅ,(jIX ``ghc-pkg``jO}rÆ,(jQ]jR]jS]jT]jV]ujJj½,jD]rÇ,jbXghc-pkgrÈ,…rÉ,}rÊ,(jIUjJjÄ,ubajMjŠubjbX).rË,…rÌ,}rÍ,(jIX).jKNjXNjYhjJj½,ubeubeubeubj’)rÎ,}rÏ,(jIUjJjµ+jKjLjMj•jO}rÐ,(jT]jS]jQ]jR]jV]Uentries]rÑ,(j˜X0setup-haddock command line option; --executablesj7UNtrÒ,aujXNjYhjD]ubjš)rÓ,}rÔ,(jIUjJjµ+jKjLjMjjO}rÕ,(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÖ,j£jÖ,ujXNjYhjD]r×,(j¥)rØ,}rÙ,(jIX --executablesrÚ,jJjÓ,jKjLjMj¨jO}rÛ,(jª]rÜ,jÚ,ajT]rÝ,j7ajS]jQ]jR]jV]rÞ,h—aj°‰ujXM¡jYhjD]rß,(j²)rà,}rá,(jIjÚ,jJjØ,jKjLjMjµjO}râ,(j½j¾jT]jS]jQ]jR]jV]ujXM¡jYhjD]rã,jbX --executablesrä,…rå,}ræ,(jIUjKNjXNjYhjJjà,ubaubj»)rç,}rè,(jIUjJjØ,jKjLjMj¾jO}ré,(j½j¾jT]jS]jQ]jR]jV]ujXM¡jYhjD]ubeubjÖ)rê,}rë,(jIUjJjÓ,jKjLjMjÙjO}rì,(jQ]jR]jS]jT]jV]ujXM¡jYhjD]rí,jy)rî,}rï,(jIXzAlso run Haddock_ for the modules of all the executable programs. By default Haddock_ is run only on the exported modules.jJjê,jKjLjMj|jO}rð,(jQ]jR]jS]jT]jV]ujXMŸjYhjD]rñ,(jbX Also run rò,…ró,}rô,(jIX Also run jKNjXNjYhjJjî,ubjœ)rõ,}rö,(jIXHaddock_jèKjJjî,jMj¥jO}r÷,(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]rø,jbXHaddockrù,…rú,}rû,(jIUjJjõ,ubaubjbX< for the modules of all the executable programs. By default rü,…rý,}rþ,(jIX< for the modules of all the executable programs. By default jKNjXNjYhjJjî,ubjœ)rÿ,}r-(jIXHaddock_jèKjJjî,jMj¥jO}r-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r-jbXHaddockr-…r-}r-(jIUjJjÿ,ubaubjbX% is run only on the exported modules.r-…r-}r-(jIX% is run only on the exported modules.jKNjXNjYhjJjî,ubeubaubeubj’)r -}r -(jIUjJjµ+jKjLjMj•jO}r -(jT]jS]jQ]jR]jV]Uentries]r -(j˜X-setup-haddock command line option; --internalh×UNtr -aujXNjYhjD]ubjš)r-}r-(jIUjJjµ+jKjLjMjjO}r-(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr-j£j-ujXNjYhjD]r-(j¥)r-}r-(jIX --internalr-jJj-jKjLjMj¨jO}r-(jª]r-j-ajT]r-h×ajS]jQ]jR]jV]r-h0aj°‰ujXM¨jYhjD]r-(j²)r-}r-(jIj-jJj-jKjLjMjµjO}r-(j½j¾jT]jS]jQ]jR]jV]ujXM¨jYhjD]r-jbX --internalr-…r -}r!-(jIUjKNjXNjYhjJj-ubaubj»)r"-}r#-(jIUjJj-jKjLjMj¾jO}r$-(j½j¾jT]jS]jQ]jR]jV]ujXM¨jYhjD]ubeubjÖ)r%-}r&-(jIUjJj-jKjLjMjÙjO}r'-(jQ]jR]jS]jT]jV]ujXM¨jYhjD]r(-jy)r)-}r*-(jIX„Run Haddock_ for the all modules, including unexposed ones, and make Haddock_ generate documentation for unexported symbols as well.jJj%-jKjLjMj|jO}r+-(jQ]jR]jS]jT]jV]ujXM¤jYhjD]r,-(jbXRun r--…r.-}r/-(jIXRun jKNjXNjYhjJj)-ubjœ)r0-}r1-(jIXHaddock_jèKjJj)-jMj¥jO}r2-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r3-jbXHaddockr4-…r5-}r6-(jIUjJj0-ubaubjbX9 for the all modules, including unexposed ones, and make r7-…r8-}r9-(jIX9 for the all modules, including unexposed ones, and make jKNjXNjYhjJj)-ubjœ)r:-}r;-(jIXHaddock_jèKjJj)-jMj¥jO}r<-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r=-jbXHaddockr>-…r?-}r@-(jIUjJj:-ubaubjbX7 generate documentation for unexported symbols as well.rA-…rB-}rC-(jIX7 generate documentation for unexported symbols as well.jKNjXNjYhjJj)-ubeubaubeubj’)rD-}rE-(jIUjJjµ+jKjLjMj•jO}rF-(jT]jS]jQ]jR]jV]Uentries]rG-(j˜X-setup-haddock command line option; --css=pathhíUNtrH-aujXNjYhjD]ubjš)rI-}rJ-(jIUjJjµ+jKjLjMjjO}rK-(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrL-j£jL-ujXNjYhjD]rM-(j¥)rN-}rO-(jIX --css=pathjJjI-jKjLjMj¨jO}rP-(jª]rQ-X--cssrR-ajT]rS-híajS]jQ]jR]jV]rT-hGaj°‰ujXM°jYhjD]rU-(j²)rV-}rW-(jIjR-jJjN-jKjLjMjµjO}rX-(j½j¾jT]jS]jQ]jR]jV]ujXM°jYhjD]rY-jbX--cssrZ-…r[-}r\-(jIUjKNjXNjYhjJjV-ubaubj»)r]-}r^-(jIX=pathjJjN-jKjLjMj¾jO}r_-(j½j¾jT]jS]jQ]jR]jV]ujXM°jYhjD]r`-jbX=pathra-…rb-}rc-(jIUjKNjXNjYhjJj]-ubaubeubjÖ)rd-}re-(jIUjJjI-jKjLjMjÙjO}rf-(jQ]jR]jS]jT]jV]ujXM°jYhjD]rg-jy)rh-}ri-(jIXÃ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.jJjd-jKjLjMj|jO}rj-(jQ]jR]jS]jT]jV]ujXM«jYhjD]rk-(jbX The argument rl-…rm-}rn-(jIX The argument jKNjXNjYhjJjh-ubj½)ro-}rp-(jIX*path*jO}rq-(jQ]jR]jS]jT]jV]ujJjh-jD]rr-jbXpathrs-…rt-}ru-(jIUjJjo-ubajMjÅubjbX( denotes a CSS file, which is passed to rv-…rw-}rx-(jIX( denotes a CSS file, which is passed to jKNjXNjYhjJjh-ubjœ)ry-}rz-(jIXHaddock_jèKjJjh-jMj¥jO}r{-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r|-jbXHaddockr}-…r~-}r-(jIUjJjy-ubaubjbXr and used to set the style of the generated documentation. This is only needed to override the default style that r€-…r-}r‚-(jIXr and used to set the style of the generated documentation. This is only needed to override the default style that jKNjXNjYhjJjh-ubjœ)rƒ-}r„-(jIXHaddock_jèKjJjh-jMj¥jO}r…-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r†-jbXHaddockr‡-…rˆ-}r‰-(jIUjJjƒ-ubaubjbX uses.rŠ-…r‹-}rŒ-(jIX uses.jKNjXNjYhjJjh-ubeubaubeubj’)r-}rŽ-(jIUjJjµ+jKjLjMj•jO}r-(jT]jS]jQ]jR]jV]Uentries]r-(j˜X5setup-haddock command line option; --hyperlink-sourcej%UNtr‘-aujXNjYhjD]ubjš)r’-}r“-(jIUjJjµ+jKjLjMjjO}r”-(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr•-j£j•-ujXNjYhjD]r–-(j¥)r—-}r˜-(jIX--hyperlink-sourcer™-jJj’-jKjLjMj¨jO}rš-(jª]r›-j™-ajT]rœ-j%ajS]jQ]jR]jV]r-h„aj°‰ujXM·jYhjD]rž-(j²)rŸ-}r -(jIj™-jJj—-jKjLjMjµjO}r¡-(j½j¾jT]jS]jQ]jR]jV]ujXM·jYhjD]r¢-jbX--hyperlink-sourcer£-…r¤-}r¥-(jIUjKNjXNjYhjJjŸ-ubaubj»)r¦-}r§-(jIUjJj—-jKjLjMj¾jO}r¨-(j½j¾jT]jS]jQ]jR]jV]ujXM·jYhjD]ubeubjÖ)r©-}rª-(jIUjJj’-jKjLjMjÙjO}r«-(jQ]jR]jS]jT]jV]ujXM·jYhjD]r¬-jy)r­-}r®-(jIXGenerate 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.jJj©-jKjLjMj|jO}r¯-(jQ]jR]jS]jT]jV]ujXM³jYhjD]r°-(jbX Generate r±-…r²-}r³-(jIX Generate jKNjXNjYhjJj­-ubjœ)r´-}rµ-(jIXHaddock_jèKjJj­-jMj¥jO}r¶-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]r·-jbXHaddockr¸-…r¹-}rº-(jIUjJj´-ubaubjbX documentation integrated with r»-…r¼-}r½-(jIX documentation integrated with jKNjXNjYhjJj­-ubjœ)r¾-}r¿-(jIX HsColour_jèKjJj­-jMj¥jO}rÀ-(UnameXHsColourjêX+http://www.cs.york.ac.uk/fp/darcs/hscolour/rÁ-jT]jS]jQ]jR]jV]ujD]rÂ-jbXHsColourrÃ-…rÄ-}rÅ-(jIUjJj¾-ubaubjbX . First, rÆ-…rÇ-}rÈ-(jIX . First, jKNjXNjYhjJj­-ubjœ)rÉ-}rÊ-(jIX HsColour_jèKjJj­-jMj¥jO}rË-(UnameXHsColourjêjÁ-jT]jS]jQ]jR]jV]ujD]rÌ-jbXHsColourrÍ-…rÎ-}rÏ-(jIUjJjÉ-ubaubjbX* is run to generate colourised code. Then rÐ-…rÑ-}rÒ-(jIX* is run to generate colourised code. Then jKNjXNjYhjJj­-ubjœ)rÓ-}rÔ-(jIXHaddock_jèKjJj­-jMj¥jO}rÕ-(UnameXHaddockjêjÏ+jT]jS]jQ]jR]jV]ujD]rÖ-jbXHaddockr×-…rØ-}rÙ-(jIUjJjÓ-ubaubjbX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.rÚ-…rÛ-}rÜ-(jIX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.jKNjXNjYhjJj­-ubeubaubeubj’)rÝ-}rÞ-(jIUjJjµ+jKjLjMj•jO}rß-(jT]jS]jQ]jR]jV]Uentries]rà-(j˜X6setup-haddock command line option; --hscolour-css=pathhúUNtrá-aujXNjYhjD]ubjš)râ-}rã-(jIUjJjµ+jKjLjMjjO}rä-(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrå-j£jå-ujXNjYhjD]ræ-(j¥)rç-}rè-(jIX--hscolour-css=pathré-jJjâ-jKjLjMj¨jO}rê-(jª]rë-X--hscolour-cssrì-ajT]rí-húajS]jQ]jR]jV]rî-hTaj°‰ujXM½jYhjD]rï-(j²)rð-}rñ-(jIjì-jJjç-jKjLjMjµjO}rò-(j½j¾jT]jS]jQ]jR]jV]ujXM½jYhjD]ró-jbX--hscolour-cssrô-…rõ-}rö-(jIUjKNjXNjYhjJjð-ubaubj»)r÷-}rø-(jIX=pathjJjç-jKjLjMj¾jO}rù-(j½j¾jT]jS]jQ]jR]jV]ujXM½jYhjD]rú-jbX=pathrû-…rü-}rý-(jIUjKNjXNjYhjJj÷-ubaubeubjÖ)rþ-}rÿ-(jIUjJjâ-jKjLjMjÙjO}r.(jQ]jR]jS]jT]jV]ujXM½jYhjD]r.(jy)r.}r.(jIXJThe argument *path* denotes a CSS file, which is passed to HsColour_ as inr.jJjþ-jKjLjMj|jO}r.(jQ]jR]jS]jT]jV]ujXMºjYhjD]r.(jbX The argument r.…r.}r .(jIX The argument jKNjXNjYhjJj.ubj½)r .}r .(jIX*path*jO}r .(jQ]jR]jS]jT]jV]ujJj.jD]r .jbXpathr.…r.}r.(jIUjJj .ubajMjÅubjbX( denotes a CSS file, which is passed to r.…r.}r.(jIX( denotes a CSS file, which is passed to jKNjXNjYhjJj.ubjœ)r.}r.(jIX HsColour_jèKjJj.jMj¥jO}r.(UnameXHsColourjêjÁ-jT]jS]jQ]jR]jV]ujD]r.jbXHsColourr.…r.}r.(jIUjJj.ubaubjbX as inr.…r.}r.(jIX as injKNjXNjYhjJj.ubeubj¦,)r.}r.(jIUjJjþ-jKjLjMj©,jO}r .(jQ]jR]jS]jT]jV]ujXNjYhjD]r!.jy)r".}r#.(jIX)runhaskell Setup.hs hscolour --css=*path*r$.jJj.jKjLjMj|jO}r%.(jQ]jR]jS]jT]jV]ujXM¼jD]r&.jbX*runhaskell Setup.hs hscolour –css=*path*r'.…r(.}r).(jIj$.jJj".ubaubaubeubeubjá)r*.}r+.(jIX.. _setup-hscolour:jJjµ+jKjLjMjäjO}r,.(jT]jS]jQ]jR]jV]jæj4ujXM¾jYhjD]ubeubjF)r-.}r..(jIUjJjçjKjLjé}r/.h”j*.sjMjNjO}r0.(jQ]jR]jS]jT]r1.(j4j#ejV]r2.(h€h”eujXMÁjYhjî}r3.j4j*.sjD]r4.(j[)r5.}r6.(jIXsetup hscolourr7.jJj-.jKjLjMj_jO}r8.(jQ]jR]jS]jT]jV]ujXMÁjYhjD]r9.jbXsetup hscolourr:.…r;.}r<.(jIj7.jKNjXNjYhjJj5.ubaubjy)r=.}r>.(jIXProduce colourised code in HTML format using HsColour_. Colourised code for exported modules is put in ``dist/doc/html/``\ *pkgid*\ ``/src``.jJj-.jKjLjMj|jO}r?.(jQ]jR]jS]jT]jV]ujXMÃjYhjD]r@.(jbX-Produce colourised code in HTML format using rA.…rB.}rC.(jIX-Produce colourised code in HTML format using jKNjXNjYhjJj=.ubjœ)rD.}rE.(jIX HsColour_jèKjJj=.jMj¥jO}rF.(UnameXHsColourjêjÁ-jT]jS]jQ]jR]jV]ujD]rG.jbXHsColourrH.…rI.}rJ.(jIUjJjD.ubaubjbX1. Colourised code for exported modules is put in rK.…rL.}rM.(jIX1. Colourised code for exported modules is put in jKNjXNjYhjJj=.ubj‚)rN.}rO.(jIX``dist/doc/html/``jO}rP.(jQ]jR]jS]jT]jV]ujJj=.jD]rQ.jbXdist/doc/html/rR.…rS.}rT.(jIUjJjN.ubajMjŠubjbX…rU.}rV.(jIX\ rW.jKNjXNjYhjJj=.ubj½)rX.}rY.(jIX*pkgid*jO}rZ.(jQ]jR]jS]jT]jV]ujJj=.jD]r[.jbXpkgidr\.…r].}r^.(jIUjJjX.ubajMjÅubjbX…r_.}r`.(jIjW.jJj=.ubj‚)ra.}rb.(jIX``/src``jO}rc.(jQ]jR]jS]jT]jV]ujJj=.jD]rd.jbX/srcre.…rf.}rg.(jIUjJja.ubajMjŠubjbX.…rh.}ri.(jIX.jKNjXNjYhjJj=.ubeubjy)rj.}rk.(jIX)This command takes the following options:rl.jJj-.jKjLjMj|jO}rm.(jQ]jR]jS]jT]jV]ujXMÆjYhjD]rn.jbX)This command takes the following options:ro.…rp.}rq.(jIjl.jKNjXNjYhjJjj.ubaubj’)rr.}rs.(jIUjJj-.jKjLjMj•jO}rt.(jT]jS]jQ]jR]jV]Uentries]ru.(j˜X1setup-hscolour command line option; --executablesjUNtrv.aujXNjYhjD]ubjš)rw.}rx.(jIUjJj-.jKjLjMjjO}ry.(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrz.j£jz.ujXNjYhjD]r{.(j¥)r|.}r}.(jIX --executablesr~.jJjw.jKjLjMj¨jO}r.(jª]r€.j~.ajT]r.jajS]jQ]jR]jV]r‚.hvaj°‰ujXMÎjYhjD]rƒ.(j²)r„.}r….(jIj~.jJj|.jKjLjMjµjO}r†.(j½j¾jT]jS]jQ]jR]jV]ujXMÎjYhjD]r‡.jbX --executablesrˆ.…r‰.}rŠ.(jIUjKNjXNjYhjJj„.ubaubj»)r‹.}rŒ.(jIUjJj|.jKjLjMj¾jO}r.(j½j¾jT]jS]jQ]jR]jV]ujXMÎjYhjD]ubeubjÖ)rŽ.}r.(jIUjJjw.jKjLjMjÙjO}r.(jQ]jR]jS]jT]jV]ujXMÎjYhjD]r‘.jy)r’.}r“.(jIX‹Also run HsColour_ on the sources of all executable programs. Colourised code is put in ``dist/doc/html/``\ *pkgid*/*executable*\ ``/src``.jJjŽ.jKjLjMj|jO}r”.(jQ]jR]jS]jT]jV]ujXMÌjYhjD]r•.(jbX Also run r–.…r—.}r˜.(jIX Also run jKNjXNjYhjJj’.ubjœ)r™.}rš.(jIX HsColour_jèKjJj’.jMj¥jO}r›.(UnameXHsColourjêjÁ-jT]jS]jQ]jR]jV]ujD]rœ.jbXHsColourr.…rž.}rŸ.(jIUjJj™.ubaubjbXF on the sources of all executable programs. Colourised code is put in r .…r¡.}r¢.(jIXF on the sources of all executable programs. Colourised code is put in jKNjXNjYhjJj’.ubj‚)r£.}r¤.(jIX``dist/doc/html/``jO}r¥.(jQ]jR]jS]jT]jV]ujJj’.jD]r¦.jbXdist/doc/html/r§.…r¨.}r©.(jIUjJj£.ubajMjŠubjbX…rª.}r«.(jIX\ r¬.jKNjXNjYhjJj’.ubj½)r­.}r®.(jIX*pkgid*jO}r¯.(jQ]jR]jS]jT]jV]ujJj’.jD]r°.jbXpkgidr±.…r².}r³.(jIUjJj­.ubajMjÅubjbX/…r´.}rµ.(jIX/jKNjXNjYhjJj’.ubj½)r¶.}r·.(jIX *executable*jO}r¸.(jQ]jR]jS]jT]jV]ujJj’.jD]r¹.jbX executablerº.…r».}r¼.(jIUjJj¶.ubajMjÅubjbX…r½.}r¾.(jIj¬.jJj’.ubj‚)r¿.}rÀ.(jIX``/src``jO}rÁ.(jQ]jR]jS]jT]jV]ujJj’.jD]rÂ.jbX/srcrÃ.…rÄ.}rÅ.(jIUjJj¿.ubajMjŠubjbX.…rÆ.}rÇ.(jIX.jKNjXNjYhjJj’.ubeubaubeubj’)rÈ.}rÉ.(jIUjJj-.jKjLjMj•jO}rÊ.(jT]jS]jQ]jR]jV]Uentries]rË.(j˜X.setup-hscolour command line option; --css=pathhºUNtrÌ.aujXNjYhjD]ubjš)rÍ.}rÎ.(jIUjJj-.jKjLjMjjO}rÏ.(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÐ.j£jÐ.ujXNjYhjD]rÑ.(j¥)rÒ.}rÓ.(jIX --css=pathjJjÍ.jKjLjMj¨jO}rÔ.(jª]rÕ.X--cssrÖ.ajT]r×.hºajS]jQ]jR]jV]rØ.haj°‰ujXMÕjYhjD]rÙ.(j²)rÚ.}rÛ.(jIjÖ.jJjÒ.jKjLjMjµjO}rÜ.(j½j¾jT]jS]jQ]jR]jV]ujXMÕjYhjD]rÝ.jbX--cssrÞ.…rß.}rà.(jIUjKNjXNjYhjJjÚ.ubaubj»)rá.}râ.(jIX=pathjJjÒ.jKjLjMj¾jO}rã.(j½j¾jT]jS]jQ]jR]jV]ujXMÕjYhjD]rä.jbX=pathrå.…ræ.}rç.(jIUjKNjXNjYhjJjá.ubaubeubjÖ)rè.}ré.(jIUjJjÍ.jKjLjMjÙjO}rê.(jQ]jR]jS]jT]jV]ujXMÕjYhjD]rë.jy)rì.}rí.(jIXþ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.jJjè.jKjLjMj|jO}rî.(jQ]jR]jS]jT]jV]ujXMÑjYhjD]rï.(jbXÒ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ò.(jIXÒ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 jKNjXNjYhjJjì.ubj‚)ró.}rô.(jIX``hscolour.css``jO}rõ.(jQ]jR]jS]jT]jV]ujJjì.jD]rö.jbX hscolour.cssr÷.…rø.}rù.(jIUjJjó.ubajMjŠubjbX) rather than linking to it.rú.…rû.}rü.(jIX) rather than linking to it.jKNjXNjYhjJjì.ubeubaubeubjá)rý.}rþ.(jIX.. _setup-install:jJj-.jKjLjMjäjO}rÿ.(jT]jS]jQ]jR]jV]jæhäujXMÖjYhjD]ubeubjF)r/}r/(jIUjJjçjKjLjé}r/h=jý.sjMjNjO}r/(jQ]jR]jS]jT]r/(hähêejV]r/(hDh=eujXMÙjYhjî}r/häjý.sjD]r/(j[)r/}r /(jIX setup installr /jJj/jKjLjMj_jO}r /(jQ]jR]jS]jT]jV]ujXMÙjYhjD]r /jbX setup installr /…r/}r/(jIj /jKNjXNjYhjJj/ubaubjy)r/}r/(jIX¥Copy the files into the install locations and (for library packages) register the package with the compiler, i.e. make the modules it contains available to programs.r/jJj/jKjLjMj|jO}r/(jQ]jR]jS]jT]jV]ujXMÝjYhjD]r/jbX¥Copy the files into the install locations and (for library packages) register the package with the compiler, i.e. make the modules it contains available to programs.r/…r/}r/(jIj/jKNjXNjYhjJj/ubaubjy)r/}r/(jIX`The `install locations <#installation-paths>`__ are determined by options to `setup configure`_.jJj/jKjLjMj|jO}r/(jQ]jR]jS]jT]jV]ujXMájYhjD]r/(jbXThe r/…r/}r/(jIXThe jKNjXNjYhjJj/ubjœ)r/}r /(jIX+`install locations <#installation-paths>`__jO}r!/(UnameXinstall locationsjêX#installation-pathsjT]jS]jQ]jR]jV]ujJj/jD]r"/jbXinstall locationsr#/…r$/}r%/(jIUjJj/ubajMj¥ubjbX are determined by options to r&/…r'/}r(/(jIX are determined by options to jKNjXNjYhjJj/ubjœ)r)/}r*/(jIX`setup configure`_jèKjJj/jMj¥jO}r+/(UnameXsetup configurejT]jS]jQ]jR]jV]jæj&ujD]r,/jbXsetup configurer-/…r./}r//(jIUjJj)/ubaubjbX.…r0/}r1/(jIX.jKNjXNjYhjJj/ubeubjy)r2/}r3/(jIX)This command takes the following options:r4/jJj/jKjLjMj|jO}r5/(jQ]jR]jS]jT]jV]ujXMäjYhjD]r6/jbX)This command takes the following options:r7/…r8/}r9/(jIj4/jKNjXNjYhjJj2/ubaubj’)r:/}r;/(jIUjJj/jKjLjMj•jO}r/aujXNjYhjD]ubjš)r?/}r@/(jIUjJj/jKjLjMjjO}rA/(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrB/j£jB/ujXNjYhjD]rC/(j¥)rD/}rE/(jIX--globalrF/jJj?/jKjLjMj¨jO}rG/(jª]rH/jF/ajT]rI/jajS]jQ]jR]jV]rJ/h^aj°‰ujXMëjYhjD]rK/(j²)rL/}rM/(jIjF/jJjD/jKjLjMjµjO}rN/(j½j¾jT]jS]jQ]jR]jV]ujXMëjYhjD]rO/jbX--globalrP/…rQ/}rR/(jIUjKNjXNjYhjJjL/ubaubj»)rS/}rT/(jIUjJjD/jKjLjMj¾jO}rU/(j½j¾jT]jS]jQ]jR]jV]ujXMëjYhjD]ubeubjÖ)rV/}rW/(jIUjJj?/jKjLjMjÙjO}rX/(jQ]jR]jS]jT]jV]ujXMëjYhjD]rY/jy)rZ/}r[/(jIX§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.)jJjV/jKjLjMj|jO}r\/(jQ]jR]jS]jT]jV]ujXMèjYhjD]r]/(jbXTRegister this package in the system-wide database. (This is the default, unless the r^/…r_/}r`/(jIXTRegister this package in the system-wide database. (This is the default, unless the jKNjXNjYhjJjZ/ubj­)ra/}rb/(jIX :option:`setup configure --user`rc/jJjZ/jKjLjMj±jO}rd/(UreftypeXoptionj³ˆj´Xsetup configure --userU refdomainXstdre/jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸X setup-installrf/ujXMèjD]rg/j‚)rh/}ri/(jIjc/jO}rj/(jQ]jR]rk/(j¾je/X std-optionrl/ejS]jT]jV]ujJja/jD]rm/jbXsetup configure --userrn/…ro/}rp/(jIUjJjh/ubajMjŠubaubjbX option was supplied to the rq/…rr/}rs/(jIX option was supplied to the jKNjXNjYhjJjZ/ubj‚)rt/}ru/(jIX ``configure``jO}rv/(jQ]jR]jS]jT]jV]ujJjZ/jD]rw/jbX configurerx/…ry/}rz/(jIUjJjt/ubajMjŠubjbX command.)r{/…r|/}r}/(jIX command.)jKNjXNjYhjJjZ/ubeubaubeubj’)r~/}r/(jIUjJj/jKjLjMj•jO}r€/(jT]jS]jQ]jR]jV]Uentries]r/(j˜X)setup-install command line option; --userjUNtr‚/aujXNjYhjD]ubjš)rƒ/}r„/(jIUjJj/jKjLjMjjO}r…/(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr†/j£j†/ujXNjYhjD]r‡/(j¥)rˆ/}r‰/(jIX--userrŠ/jJjƒ/jKjLjMj¨jO}r‹/(jª]rŒ/jŠ/ajT]r/jajS]jQ]jR]jV]rŽ/hlaj°‰ujXMñjYhjD]r/(j²)r/}r‘/(jIjŠ/jJjˆ/jKjLjMjµjO}r’/(j½j¾jT]jS]jQ]jR]jV]ujXMñjYhjD]r“/jbX--userr”/…r•/}r–/(jIUjKNjXNjYhjJj/ubaubj»)r—/}r˜/(jIUjJjˆ/jKjLjMj¾jO}r™/(j½j¾jT]jS]jQ]jR]jV]ujXMñjYhjD]ubeubjÖ)rš/}r›/(jIUjJjƒ/jKjLjMjÙjO}rœ/(jQ]jR]jS]jT]jV]ujXMñjYhjD]r/jy)rž/}rŸ/(jIX«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.)jJjš/jKjLjMj|jO}r /(jQ]jR]jS]jT]jV]ujXMîjYhjD]r¡/(jbXZRegister this package in the user’s local package database. (This is the default if the r¢/…r£/}r¤/(jIXXRegister this package in the user's local package database. (This is the default if the jKNjXNjYhjJjž/ubj­)r¥/}r¦/(jIX :option:`setup configure --user`r§/jJjž/jKjLjMj±jO}r¨/(UreftypeXoptionj³ˆj´Xsetup configure --userU refdomainXstdr©/jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸jf/ujXMîjD]rª/j‚)r«/}r¬/(jIj§/jO}r­/(jQ]jR]r®/(j¾j©/X std-optionr¯/ejS]jT]jV]ujJj¥/jD]r°/jbXsetup configure --userr±/…r²/}r³/(jIUjJj«/ubajMjŠubaubjbX option was supplied to the r´/…rµ/}r¶/(jIX option was supplied to the jKNjXNjYhjJjž/ubj‚)r·/}r¸/(jIX ``configure``jO}r¹/(jQ]jR]jS]jT]jV]ujJjž/jD]rº/jbX configurer»/…r¼/}r½/(jIUjJj·/ubajMjŠubjbX command.)r¾/…r¿/}rÀ/(jIX command.)jKNjXNjYhjJjž/ubeubaubeubjá)rÁ/}rÂ/(jIX.. _setup-copy:jJj/jKjLjMjäjO}rÃ/(jT]jS]jQ]jR]jV]jæj@ujXMòjYhjD]ubeubjF)rÄ/}rÅ/(jIUjJjçjKjLjé}rÆ/h jÁ/sjMjNjO}rÇ/(jQ]jR]jS]jT]rÈ/(j@j+ejV]rÉ/(hŠh eujXMõjYhjî}rÊ/j@jÁ/sjD]rË/(j[)rÌ/}rÍ/(jIX setup copyrÎ/jJjÄ/jKjLjMj_jO}rÏ/(jQ]jR]jS]jT]jV]ujXMõjYhjD]rÐ/jbX setup copyrÑ/…rÒ/}rÓ/(jIjÎ/jKNjXNjYhjJjÌ/ubaubjy)rÔ/}rÕ/(jIXiCopy the files without registering them. This command is mainly of use to those creating binary packages.rÖ/jJjÄ/jKjLjMj|jO}r×/(jQ]jR]jS]jT]jV]ujXM÷jYhjD]rØ/jbXiCopy the files without registering them. This command is mainly of use to those creating binary packages.rÙ/…rÚ/}rÛ/(jIjÖ/jKNjXNjYhjJjÔ/ubaubjy)rÜ/}rÝ/(jIX(This command takes the following option:rÞ/jJjÄ/jKjLjMj|jO}rß/(jQ]jR]jS]jT]jV]ujXMújYhjD]rà/jbX(This command takes the following option:rá/…râ/}rã/(jIjÞ/jKNjXNjYhjJjÜ/ubaubj’)rä/}rå/(jIUjJjÄ/jKjLjMj•jO}ræ/(jT]jS]jQ]jR]jV]Uentries]rç/(j˜X.setup-copy command line option; --destdir=pathhîUNtrè/aujXNjYhjD]ubjš)ré/}rê/(jIUjJjÄ/jKjLjMjjO}rë/(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrì/j£jì/ujXNjYhjD]rí/(j¥)rî/}rï/(jIX--destdir=pathjJjé/jKjLjMj¨jO}rð/(jª]rñ/X --destdirrò/ajT]ró/hîajS]jQ]jR]jV]rô/hHaj°‰ujXMjYhjD]rõ/(j²)rö/}r÷/(jIjò/jJjî/jKjLjMjµjO}rø/(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rù/jbX --destdirrú/…rû/}rü/(jIUjKNjXNjYhjJjö/ubaubj»)rý/}rþ/(jIX=pathjJjî/jKjLjMj¾jO}rÿ/(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r0jbX=pathr0…r0}r0(jIUjKNjXNjYhjJjý/ubaubeubjÖ)r0}r0(jIUjJjé/jKjLjMjÙjO}r0(jQ]jR]jS]jT]jV]ujXMjYhjD]r0jy)r0}r 0(jIXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r 0jJj0jKjLjMj|jO}r 0(jQ]jR]jS]jT]jV]ujXMjYhjD]r 0jbXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r 0…r0}r0(jIj 0jKNjXNjYhjJj0ubaubaubeubjá)r0}r0(jIX.. _setup-register:jJjÄ/jKjLjMjäjO}r0(jT]jS]jQ]jR]jV]jæjujXMjYhjD]ubeubjF)r0}r0(jIUjJjçjKjLjé}r0h\j0sjMjNjO}r0(jQ]jR]jS]jT]r0(jhÊejV]r0(h#h\eujXMjYhjî}r0jj0sjD]r0(j[)r0}r0(jIXsetup registerr0jJj0jKjLjMj_jO}r0(jQ]jR]jS]jT]jV]ujXMjYhjD]r0jbXsetup registerr 0…r!0}r"0(jIj0jKNjXNjYhjJj0ubaubjy)r#0}r$0(jIX&Register this package with the compiler, i.e. make the modules it contains available to programs. This only makes sense for library packages. Note that the ``install`` command incorporates this action. The main use of this separate command is in the post-installation step for a binary package.jJj0jKjLjMj|jO}r%0(jQ]jR]jS]jT]jV]ujXMjYhjD]r&0(jbXœRegister this package with the compiler, i.e. make the modules it contains available to programs. This only makes sense for library packages. Note that the r'0…r(0}r)0(jIXœRegister this package with the compiler, i.e. make the modules it contains available to programs. This only makes sense for library packages. Note that the jKNjXNjYhjJj#0ubj‚)r*0}r+0(jIX ``install``jO}r,0(jQ]jR]jS]jT]jV]ujJj#0jD]r-0jbXinstallr.0…r/0}r00(jIUjJj*0ubajMjŠubjbX command incorporates this action. The main use of this separate command is in the post-installation step for a binary package.r10…r20}r30(jIX command incorporates this action. The main use of this separate command is in the post-installation step for a binary package.jKNjXNjYhjJj#0ubeubjy)r40}r50(jIX)This command takes the following options:r60jJj0jKjLjMj|jO}r70(jQ]jR]jS]jT]jV]ujXMjYhjD]r80jbX)This command takes the following options:r90…r:0}r;0(jIj60jKNjXNjYhjJj40ubaubj’)r<0}r=0(jIUjJj0jKjLjMj•jO}r>0(jT]jS]jQ]jR]jV]Uentries]r?0(j˜X,setup-register command line option; --globalj)UNtr@0aujXNjYhjD]ubjš)rA0}rB0(jIUjJj0jKjLjMjjO}rC0(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrD0j£jD0ujXNjYhjD]rE0(j¥)rF0}rG0(jIX--globalrH0jJjA0jKjLjMj¨jO}rI0(jª]rJ0jH0ajT]rK0j)ajS]jQ]jR]jV]rL0hˆaj°‰ujXMjYhjD]rM0(j²)rN0}rO0(jIjH0jJjF0jKjLjMjµjO}rP0(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]rQ0jbX--globalrR0…rS0}rT0(jIUjKNjXNjYhjJjN0ubaubj»)rU0}rV0(jIUjJjF0jKjLjMj¾jO}rW0(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubeubjÖ)rX0}rY0(jIUjJjA0jKjLjMjÙjO}rZ0(jQ]jR]jS]jT]jV]ujXMjYhjD]r[0jy)r\0}r]0(jIXIRegister this package in the system-wide database. (This is the default.)r^0jJjX0jKjLjMj|jO}r_0(jQ]jR]jS]jT]jV]ujXMjYhjD]r`0jbXIRegister this package in the system-wide database. (This is the default.)ra0…rb0}rc0(jIj^0jKNjXNjYhjJj\0ubaubaubeubj’)rd0}re0(jIUjJj0jKjLjMj•jO}rf0(jT]jS]jQ]jR]jV]Uentries]rg0(j˜X*setup-register command line option; --userjUNtrh0aujXNjYhjD]ubjš)ri0}rj0(jIUjJj0jKjLjMjjO}rk0(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrl0j£jl0ujXNjYhjD]rm0(j¥)rn0}ro0(jIX--userrp0jJji0jKjLjMj¨jO}rq0(jª]rr0jp0ajT]rs0jajS]jQ]jR]jV]rt0hraj°‰ujXMjYhjD]ru0(j²)rv0}rw0(jIjp0jJjn0jKjLjMjµjO}rx0(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ry0jbX--userrz0…r{0}r|0(jIUjKNjXNjYhjJjv0ubaubj»)r}0}r~0(jIUjJjn0jKjLjMj¾jO}r0(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]ubeubjÖ)r€0}r0(jIUjJji0jKjLjMjÙjO}r‚0(jQ]jR]jS]jT]jV]ujXMjYhjD]rƒ0jy)r„0}r…0(jIX;Register this package in the user's local package database.r†0jJj€0jKjLjMj|jO}r‡0(jQ]jR]jS]jT]jV]ujXMjYhjD]rˆ0jbX=Register this package in the user’s local package database.r‰0…rŠ0}r‹0(jIj†0jKNjXNjYhjJj„0ubaubaubeubj’)rŒ0}r0(jIUjJj0jKjLjMj•jO}rŽ0(jT]jS]jQ]jR]jV]Uentries]r0(j˜X0setup-register command line option; --gen-scriptj'UNtr0aujXNjYhjD]ubjš)r‘0}r’0(jIUjJj0jKjLjMjjO}r“0(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr”0j£j”0ujXNjYhjD]r•0(j¥)r–0}r—0(jIX --gen-scriptr˜0jJj‘0jKjLjMj¨jO}r™0(jª]rš0j˜0ajT]r›0j'ajS]jQ]jR]jV]rœ0h†aj°‰ujXM"jYhjD]r0(j²)rž0}rŸ0(jIj˜0jJj–0jKjLjMjµjO}r 0(j½j¾jT]jS]jQ]jR]jV]ujXM"jYhjD]r¡0jbX --gen-scriptr¢0…r£0}r¤0(jIUjKNjXNjYhjJjž0ubaubj»)r¥0}r¦0(jIUjJj–0jKjLjMj¾jO}r§0(j½j¾jT]jS]jQ]jR]jV]ujXM"jYhjD]ubeubjÖ)r¨0}r©0(jIUjJj‘0jKjLjMjÙjO}rª0(jQ]jR]jS]jT]jV]ujXM"jYhjD]r«0jy)r¬0}r­0(jIX!Instead of registering the package, generate a script containing commands to perform the registration. On Unix, this file is called ``register.sh``, on Windows, ``register.bat``. This script might be included in a binary bundle, to be run after the bundle is unpacked on the target system.jJj¨0jKjLjMj|jO}r®0(jQ]jR]jS]jT]jV]ujXMjYhjD]r¯0(jbX„Instead of registering the package, generate a script containing commands to perform the registration. On Unix, this file is called r°0…r±0}r²0(jIX„Instead of registering the package, generate a script containing commands to perform the registration. On Unix, this file is called jKNjXNjYhjJj¬0ubj‚)r³0}r´0(jIX``register.sh``jO}rµ0(jQ]jR]jS]jT]jV]ujJj¬0jD]r¶0jbX register.shr·0…r¸0}r¹0(jIUjJj³0ubajMjŠubjbX, on Windows, rº0…r»0}r¼0(jIX, on Windows, jKNjXNjYhjJj¬0ubj‚)r½0}r¾0(jIX``register.bat``jO}r¿0(jQ]jR]jS]jT]jV]ujJj¬0jD]rÀ0jbX register.batrÁ0…rÂ0}rÃ0(jIUjJj½0ubajMjŠubjbXp. This script might be included in a binary bundle, to be run after the bundle is unpacked on the target system.rÄ0…rÅ0}rÆ0(jIXp. This script might be included in a binary bundle, to be run after the bundle is unpacked on the target system.jKNjXNjYhjJj¬0ubeubaubeubj’)rÇ0}rÈ0(jIUjJj0jKjLjMj•jO}rÉ0(jT]jS]jQ]jR]jV]Uentries]rÊ0(j˜X;setup-register command line option; --gen-pkg-config[=path]hþUNtrË0aujXNjYhjD]ubjš)rÌ0}rÍ0(jIUjJj0jKjLjMjjO}rÎ0(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÏ0j£jÏ0ujXNjYhjD]rÐ0(j¥)rÑ0}rÒ0(jIX--gen-pkg-config[=path]jJjÌ0jKjLjMj¨jO}rÓ0(jª]rÔ0X--gen-pkg-config[rÕ0ajT]rÖ0hþajS]jQ]jR]jV]r×0hXaj°‰ujXM4jYhjD]rØ0(j²)rÙ0}rÚ0(jIjÕ0jJjÑ0jKjLjMjµjO}rÛ0(j½j¾jT]jS]jQ]jR]jV]ujXM4jYhjD]rÜ0jbX--gen-pkg-config[rÝ0…rÞ0}rß0(jIUjKNjXNjYhjJjÙ0ubaubj»)rà0}rá0(jIX=path]jJjÑ0jKjLjMj¾jO}râ0(j½j¾jT]jS]jQ]jR]jV]ujXM4jYhjD]rã0jbX=path]rä0…rå0}ræ0(jIUjKNjXNjYhjJjà0ubaubeubjÖ)rç0}rè0(jIUjJjÌ0jKjLjMjÙjO}ré0(jQ]jR]jS]jT]jV]ujXM4jYhjD]rê0(jy)rë0}rì0(jIX„Instead of registering the package, generate a package registration file (or directory, in some circumstances). This only applies to compilers that support package registration files which at the moment is only GHC. The file should be used with the compiler's mechanism for registering packages. This option is mainly intended for packaging systems. If possible use the :option:`--gen-script` option instead since it is more portable across Haskell implementations. The *path* is optional and can be used to specify a particular output file to generate. Otherwise, by default the file is the package name and version with a ``.conf`` extension.jJjç0jKjLjMj|jO}rí0(jQ]jR]jS]jT]jV]ujXM%jYhjD]rî0(jbXtInstead of registering the package, generate a package registration file (or directory, in some circumstances). This only applies to compilers that support package registration files which at the moment is only GHC. The file should be used with the compiler’s mechanism for registering packages. This option is mainly intended for packaging systems. If possible use the rï0…rð0}rñ0(jIXrInstead of registering the package, generate a package registration file (or directory, in some circumstances). This only applies to compilers that support package registration files which at the moment is only GHC. The file should be used with the compiler's mechanism for registering packages. This option is mainly intended for packaging systems. If possible use the jKNjXNjYhjJjë0ubj­)rò0}ró0(jIX:option:`--gen-script`rô0jJjë0jKjLjMj±jO}rõ0(UreftypeXoptionj³ˆj´X --gen-scriptU refdomainXstdrö0jT]jS]U refexplicit‰jQ]jR]jV]j¶j·j¸Xsetup-registerr÷0ujXM%jD]rø0j‚)rù0}rú0(jIjô0jO}rû0(jQ]jR]rü0(j¾jö0X std-optionrý0ejS]jT]jV]ujJjò0jD]rþ0jbX --gen-scriptrÿ0…r1}r1(jIUjJjù0ubajMjŠubaubjbXN option instead since it is more portable across Haskell implementations. The r1…r1}r1(jIXN option instead since it is more portable across Haskell implementations. The jKNjXNjYhjJjë0ubj½)r1}r1(jIX*path*jO}r1(jQ]jR]jS]jT]jV]ujJjë0jD]r1jbXpathr 1…r 1}r 1(jIUjJj1ubajMjÅubjbX” is optional and can be used to specify a particular output file to generate. Otherwise, by default the file is the package name and version with a r 1…r 1}r1(jIX” is optional and can be used to specify a particular output file to generate. Otherwise, by default the file is the package name and version with a jKNjXNjYhjJjë0ubj‚)r1}r1(jIX ``.conf``jO}r1(jQ]jR]jS]jT]jV]ujJjë0jD]r1jbX.confr1…r1}r1(jIUjJj1ubajMjŠubjbX extension.r1…r1}r1(jIX extension.jKNjXNjYhjJjë0ubeubjy)r1}r1(jIXÝ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.r1jJjç0jKjLjMj|jO}r1(jQ]jR]jS]jT]jV]ujXM0jYhjD]r1jbXÝ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.r1…r1}r 1(jIj1jKNjXNjYhjJj1ubaubeubeubj’)r!1}r"1(jIUjJj0jKjLjMj•jO}r#1(jT]jS]jQ]jR]jV]Uentries]r$1(j˜X-setup-register command line option; --inplacejUNtr%1aujXNjYhjD]ubjš)r&1}r'1(jIUjJj0jKjLjMjjO}r(1(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr)1j£j)1ujXNjYhjD]r*1(j¥)r+1}r,1(jIX --inplacer-1jJj&1jKjLjMj¨jO}r.1(jª]r/1j-1ajT]r01jajS]jQ]jR]jV]r11huaj°‰ujXMCjYhjD]r21(j²)r31}r41(jIj-1jJj+1jKjLjMjµjO}r51(j½j¾jT]jS]jQ]jR]jV]ujXMCjYhjD]r61jbX --inplacer71…r81}r91(jIUjKNjXNjYhjJj31ubaubj»)r:1}r;1(jIUjJj+1jKjLjMj¾jO}r<1(j½j¾jT]jS]jQ]jR]jV]ujXMCjYhjD]ubeubjÖ)r=1}r>1(jIUjJj&1jKjLjMjÙjO}r?1(jQ]jR]jS]jT]jV]ujXMCjYhjD]r@1(jy)rA1}rB1(jIXÎ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.rC1jJj=1jKjLjMj|jO}rD1(jQ]jR]jS]jT]jV]ujXM7jYhjD]rE1jbXÐ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.rF1…rG1}rH1(jIjC1jKNjXNjYhjJjA1ubaubjy)rI1}rJ1(jIX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.rK1jJj=1jKjLjMj|jO}rL1(jQ]jR]jS]jT]jV]ujXM<jYhjD]rM1jbX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.rN1…rO1}rP1(jIjK1jKNjXNjYhjJjI1ubaubjy)rQ1}rR1(jIXÈ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.rS1jJj=1jKjLjMj|jO}rT1(jQ]jR]jS]jT]jV]ujXM?jYhjD]rU1jbXÊ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.rV1…rW1}rX1(jIjS1jKNjXNjYhjJjQ1ubaubeubeubjá)rY1}rZ1(jIX.. _setup-unregister:jJj0jKjLjMjäjO}r[1(jT]jS]jQ]jR]jV]jæh°ujXMDjYhjD]ubeubjF)r\1}r]1(jIUjJjçjKjLjé}r^1h jY1sjMjNjO}r_1(jQ]jR]jS]jT]r`1(h°j,ejV]ra1(h‹h eujXMGjYhjî}rb1h°jY1sjD]rc1(j[)rd1}re1(jIXsetup unregisterrf1jJj\1jKjLjMj_jO}rg1(jQ]jR]jS]jT]jV]ujXMGjYhjD]rh1jbXsetup unregisterri1…rj1}rk1(jIjf1jKNjXNjYhjJjd1ubaubjy)rl1}rm1(jIX*Deregister this package with the compiler.rn1jJj\1jKjLjMj|jO}ro1(jQ]jR]jS]jT]jV]ujXMKjYhjD]rp1jbX*Deregister this package with the compiler.rq1…rr1}rs1(jIjn1jKNjXNjYhjJjl1ubaubjy)rt1}ru1(jIX)This command takes the following options:rv1jJj\1jKjLjMj|jO}rw1(jQ]jR]jS]jT]jV]ujXMMjYhjD]rx1jbX)This command takes the following options:ry1…rz1}r{1(jIjv1jKNjXNjYhjJjt1ubaubj’)r|1}r}1(jIUjJj\1jKjLjMj•jO}r~1(jT]jS]jQ]jR]jV]Uentries]r1(j˜X.setup-unregister command line option; --globalhÿUNtr€1aujXNjYhjD]ubjš)r1}r‚1(jIUjJj\1jKjLjMjjO}rƒ1(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr„1j£j„1ujXNjYhjD]r…1(j¥)r†1}r‡1(jIX--globalrˆ1jJj1jKjLjMj¨jO}r‰1(jª]rŠ1jˆ1ajT]r‹1hÿajS]jQ]jR]jV]rŒ1hYaj°‰ujXMSjYhjD]r1(j²)rŽ1}r1(jIjˆ1jJj†1jKjLjMjµjO}r1(j½j¾jT]jS]jQ]jR]jV]ujXMSjYhjD]r‘1jbX--globalr’1…r“1}r”1(jIUjKNjXNjYhjJjŽ1ubaubj»)r•1}r–1(jIUjJj†1jKjLjMj¾jO}r—1(j½j¾jT]jS]jQ]jR]jV]ujXMSjYhjD]ubeubjÖ)r˜1}r™1(jIUjJj1jKjLjMjÙjO}rš1(jQ]jR]jS]jT]jV]ujXMSjYhjD]r›1jy)rœ1}r1(jIXKDeregister this package in the system-wide database. (This is the default.)rž1jJj˜1jKjLjMj|jO}rŸ1(jQ]jR]jS]jT]jV]ujXMQjYhjD]r 1jbXKDeregister this package in the system-wide database. (This is the default.)r¡1…r¢1}r£1(jIjž1jKNjXNjYhjJjœ1ubaubaubeubj’)r¤1}r¥1(jIUjJj\1jKjLjMj•jO}r¦1(jT]jS]jQ]jR]jV]Uentries]r§1(j˜X,setup-unregister command line option; --userh¾UNtr¨1aujXNjYhjD]ubjš)r©1}rª1(jIUjJj\1jKjLjMjjO}r«1(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr¬1j£j¬1ujXNjYhjD]r­1(j¥)r®1}r¯1(jIX--userr°1jJj©1jKjLjMj¨jO}r±1(jª]r²1j°1ajT]r³1h¾ajS]jQ]jR]jV]r´1haj°‰ujXMWjYhjD]rµ1(j²)r¶1}r·1(jIj°1jJj®1jKjLjMjµjO}r¸1(j½j¾jT]jS]jQ]jR]jV]ujXMWjYhjD]r¹1jbX--userrº1…r»1}r¼1(jIUjKNjXNjYhjJj¶1ubaubj»)r½1}r¾1(jIUjJj®1jKjLjMj¾jO}r¿1(j½j¾jT]jS]jQ]jR]jV]ujXMWjYhjD]ubeubjÖ)rÀ1}rÁ1(jIUjJj©1jKjLjMjÙjO}rÂ1(jQ]jR]jS]jT]jV]ujXMWjYhjD]rÃ1jy)rÄ1}rÅ1(jIX=Deregister this package in the user's local package database.rÆ1jJjÀ1jKjLjMj|jO}rÇ1(jQ]jR]jS]jT]jV]ujXMVjYhjD]rÈ1jbX?Deregister this package in the user’s local package database.rÉ1…rÊ1}rË1(jIjÆ1jKNjXNjYhjJjÄ1ubaubaubeubj’)rÌ1}rÍ1(jIUjJj\1jKjLjMj•jO}rÎ1(jT]jS]jQ]jR]jV]Uentries]rÏ1(j˜X2setup-unregister command line option; --gen-scripthçUNtrÐ1aujXNjYhjD]ubjš)rÑ1}rÒ1(jIUjJj\1jKjLjMjjO}rÓ1(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÔ1j£jÔ1ujXNjYhjD]rÕ1(j¥)rÖ1}r×1(jIX --gen-scriptrØ1jJjÑ1jKjLjMj¨jO}rÙ1(jª]rÚ1jØ1ajT]rÛ1hçajS]jQ]jR]jV]rÜ1h@aj°‰ujXM^jYhjD]rÝ1(j²)rÞ1}rß1(jIjØ1jJjÖ1jKjLjMjµjO}rà1(j½j¾jT]jS]jQ]jR]jV]ujXM^jYhjD]rá1jbX --gen-scriptrâ1…rã1}rä1(jIUjKNjXNjYhjJjÞ1ubaubj»)rå1}ræ1(jIUjJjÖ1jKjLjMj¾jO}rç1(j½j¾jT]jS]jQ]jR]jV]ujXM^jYhjD]ubeubjÖ)rè1}ré1(jIUjJjÑ1jKjLjMjÙjO}rê1(jQ]jR]jS]jT]jV]ujXM^jYhjD]rë1jy)rì1}rí1(jIX 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.jJjè1jKjLjMj|jO}rî1(jQ]jR]jS]jT]jV]ujXMZjYhjD]rï1(jbXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called rð1…rñ1}rò1(jIXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called jKNjXNjYhjJjì1ubj‚)ró1}rô1(jIX``unregister.sh``jO}rõ1(jQ]jR]jS]jT]jV]ujJjì1jD]rö1jbX unregister.shr÷1…rø1}rù1(jIUjJjó1ubajMjŠubjbX, on Windows, rú1…rû1}rü1(jIX, on Windows, jKNjXNjYhjJjì1ubj‚)rý1}rþ1(jIX``unregister.bat``jO}rÿ1(jQ]jR]jS]jT]jV]ujJjì1jD]r2jbXunregister.batr2…r2}r2(jIUjJjý1ubajMjŠubjbXS. This script might be included in a binary bundle, to be run on the target system.r2…r2}r2(jIXS. This script might be included in a binary bundle, to be run on the target system.jKNjXNjYhjJjì1ubeubaubeubjá)r2}r2(jIX.. _setup-clean:jJj\1jKjLjMjäjO}r 2(jT]jS]jQ]jR]jV]jæh´ujXM_jYhjD]ubeubjF)r 2}r 2(jIUjJjçjKjLjé}r 2h j2sjMjNjO}r 2(jQ]jR]jS]jT]r2(h´j ejV]r2(hdh eujXMbjYhjî}r2h´j2sjD]r2(j[)r2}r2(jIX setup cleanr2jJj 2jKjLjMj_jO}r2(jQ]jR]jS]jT]jV]ujXMbjYhjD]r2jbX setup cleanr2…r2}r2(jIj2jKNjXNjYhjJj2ubaubjy)r2}r2(jIXË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.jJj 2jKjLjMj|jO}r2(jQ]jR]jS]jT]jV]ujXMdjYhjD]r2(jbX*Remove any local files created during the r2…r2}r 2(jIX*Remove any local files created during the jKNjXNjYhjJj2ubj‚)r!2}r"2(jIX ``configure``jO}r#2(jQ]jR]jS]jT]jV]ujJj2jD]r$2jbX configurer%2…r&2}r'2(jIUjJj!2ubajMjŠubjbX, r(2…r)2}r*2(jIX, r+2jKNjXNjYhjJj2ubj‚)r,2}r-2(jIX ``build``jO}r.2(jQ]jR]jS]jT]jV]ujJj2jD]r/2jbXbuildr02…r12}r22(jIUjJj,2ubajMjŠubjbX, r32…r42}r52(jIX, jKNjXNjYhjJj2ubj‚)r62}r72(jIX ``haddock``jO}r82(jQ]jR]jS]jT]jV]ujJj2jD]r92jbXhaddockr:2…r;2}r<2(jIUjJj62ubajMjŠubjbX, r=2…r>2}r?2(jIj+2jJj2ubj‚)r@2}rA2(jIX ``register``jO}rB2(jQ]jR]jS]jT]jV]ujJj2jD]rC2jbXregisterrD2…rE2}rF2(jIUjJj@2ubajMjŠubjbX or rG2…rH2}rI2(jIX or jKNjXNjYhjJj2ubj‚)rJ2}rK2(jIX``unregister``jO}rL2(jQ]jR]jS]jT]jV]ujJj2jD]rM2jbX unregisterrN2…rO2}rP2(jIUjJjJ2ubajMjŠubjbX9 steps, and also any files and directories listed in the rQ2…rR2}rS2(jIX9 steps, and also any files and directories listed in the jKNjXNjYhjJj2ubj­)rT2}rU2(jIX:pkg-field:`extra-tmp-files`rV2jJj2jKjLjMj±jO}rW2(UreftypeX pkg-fieldj³ˆj´Xextra-tmp-filesU refdomainXcabalrX2jT]jS]U refexplicit‰jQ]jR]jV]j¶j·Ucabal:pkg-sectionrY2NujXMdjD]rZ2j‚)r[2}r\2(jIjV2jO}r]2(jQ]jR]r^2(j¾jX2Xcabal-pkg-fieldr_2ejS]jT]jV]ujJjT2jD]r`2jbXextra-tmp-filesra2…rb2}rc2(jIUjJj[2ubajMjŠubaubjbX field.rd2…re2}rf2(jIX field.jKNjXNjYhjJj2ubeubjy)rg2}rh2(jIX)This command takes the following options:ri2jJj 2jKjLjMj|jO}rj2(jQ]jR]jS]jT]jV]ujXMhjYhjD]rk2jbX)This command takes the following options:rl2…rm2}rn2(jIji2jKNjXNjYhjJjg2ubaubj’)ro2}rp2(jIUjJj 2jKjLjMj•jO}rq2(jT]jS]jQ]jR]jV]Uentries]rr2(j˜X5setup-clean command line option; --save-configure, -shÇUNtrs2aujXNjYhjD]ubjš)rt2}ru2(jIUjJj 2jKjLjMjjO}rv2(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrw2j£jw2ujXNjYhjD]rx2(j¥)ry2}rz2(jIX--save-configure, -sjJjt2jKjLjMj¨jO}r{2(jª]r|2(X--save-configurer}2X-sr~2ejT]r2hÇajS]jQ]jR]jV]r€2(hjh ej°‰ujXMpjYhjD]r2(j²)r‚2}rƒ2(jIj}2jJjy2jKjLjMjµjO}r„2(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]r…2jbX--save-configurer†2…r‡2}rˆ2(jIUjKNjXNjYhjJj‚2ubaubj»)r‰2}rŠ2(jIUjJjy2jKjLjMj¾jO}r‹2(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]ubj»)rŒ2}r2(jIjÂjJjy2jKjLjMj¾jO}rŽ2(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]r2jbX, r2…r‘2}r’2(jIUjKNjXNjYhjJjŒ2ubaubj²)r“2}r”2(jIj~2jJjy2jKjLjMjµjO}r•2(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]r–2jbX-sr—2…r˜2}r™2(jIUjKNjXNjYhjJj“2ubaubj»)rš2}r›2(jIUjJjy2jKjLjMj¾jO}rœ2(j½j¾jT]jS]jQ]jR]jV]ujXMpjYhjD]ubeubjÖ)r2}rž2(jIUjJjt2jKjLjMjÙjO}rŸ2(jQ]jR]jS]jT]jV]ujXMpjYhjD]r 2jy)r¡2}r¢2(jIXkKeeps the configuration information so it is not necessary to run the configure step again before building.r£2jJj2jKjLjMj|jO}r¤2(jQ]jR]jS]jT]jV]ujXMnjYhjD]r¥2jbXkKeeps the configuration information so it is not necessary to run the configure step again before building.r¦2…r§2}r¨2(jIj£2jKNjXNjYhjJj¡2ubaubaubeubeubjF)r©2}rª2(jIUjJjçjKjLjMjNjO}r«2(jQ]jR]jS]jT]r¬2hüajV]r­2hVaujXMrjYhjD]r®2(j[)r¯2}r°2(jIX setup testr±2jJj©2jKjLjMj_jO}r²2(jQ]jR]jS]jT]jV]ujXMrjYhjD]r³2jbX setup testr´2…rµ2}r¶2(jIj±2jKNjXNjYhjJj¯2ubaubjy)r·2}r¸2(jIX(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.jJj©2jKjLjMj|jO}r¹2(jQ]jR]jS]jT]jV]ujXMtjYhjD]rº2(jbX«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»2…r¼2}r½2(jIX«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 jKNjXNjYhjJj·2ubj‚)r¾2}r¿2(jIX``test``jO}rÀ2(jQ]jR]jS]jT]jV]ujJj·2jD]rÁ2jbXtestrÂ2…rÃ2}rÄ2(jIUjJj¾2ubajMjŠubjbXu. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.rÅ2…rÆ2}rÇ2(jIXu. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.jKNjXNjYhjJj·2ubeubj’)rÈ2}rÉ2(jIUjJj©2jKjLjMj•jO}rÊ2(jT]jS]jQ]jR]jV]Uentries]rË2(j˜X.setup-test command line option; --builddir=dirhðUNtrÌ2aujXNjYhjD]ubjš)rÍ2}rÎ2(jIUjJj©2jKjLjMjjO}rÏ2(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡XoptionrÐ2j£jÐ2ujXNjYhjD]rÑ2(j¥)rÒ2}rÓ2(jIX--builddir=dirjJjÍ2jKjLjMj¨jO}rÔ2(jª]rÕ2X --builddirrÖ2ajT]r×2hðajS]jQ]jR]jV]rØ2hJaj°‰ujXM€jYhjD]rÙ2(j²)rÚ2}rÛ2(jIjÖ2jJjÒ2jKjLjMjµjO}rÜ2(j½j¾jT]jS]jQ]jR]jV]ujXM€jYhjD]rÝ2jbX --builddirrÞ2…rß2}rà2(jIUjKNjXNjYhjJjÚ2ubaubj»)rá2}râ2(jIX=dirjJjÒ2jKjLjMj¾jO}rã2(j½j¾jT]jS]jQ]jR]jV]ujXM€jYhjD]rä2jbX=dirrå2…ræ2}rç2(jIUjKNjXNjYhjJjá2ubaubeubjÖ)rè2}ré2(jIUjJjÍ2jKjLjMjÙjO}rê2(jQ]jR]jS]jT]jV]ujXM€jYhjD]rë2jy)rì2}rí2(jIXThe directory where Cabal puts generated build files (default: ``dist``). Test logs will be located in the ``test`` subdirectory.jJjè2jKjLjMj|jO}rî2(jQ]jR]jS]jT]jV]ujXM~jYhjD]rï2(jbX?The directory where Cabal puts generated build files (default: rð2…rñ2}rò2(jIX?The directory where Cabal puts generated build files (default: jKNjXNjYhjJjì2ubj‚)ró2}rô2(jIX``dist``jO}rõ2(jQ]jR]jS]jT]jV]ujJjì2jD]rö2jbXdistr÷2…rø2}rù2(jIUjJjó2ubajMjŠubjbX$). Test logs will be located in the rú2…rû2}rü2(jIX$). Test logs will be located in the jKNjXNjYhjJjì2ubj‚)rý2}rþ2(jIX``test``jO}rÿ2(jQ]jR]jS]jT]jV]ujJjì2jD]r3jbXtestr3…r3}r3(jIUjJjý2ubajMjŠubjbX subdirectory.r3…r3}r3(jIX subdirectory.jKNjXNjYhjJjì2ubeubaubeubj’)r3}r3(jIUjJj©2jKjLjMj•jO}r 3(jT]jS]jQ]jR]jV]Uentries]r 3(j˜X0setup-test command line option; --human-log=pathh³UNtr 3aujXNjYhjD]ubjš)r 3}r 3(jIUjJj©2jKjLjMjjO}r3(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr3j£j3ujXNjYhjD]r3(j¥)r3}r3(jIX--human-log=pathjJj 3jKjLjMj¨jO}r3(jª]r3X --human-logr3ajT]r3h³ajS]jQ]jR]jV]r3h aj°‰ujXM‰jYhjD]r3(j²)r3}r3(jIj3jJj3jKjLjMjµjO}r3(j½j¾jT]jS]jQ]jR]jV]ujXM‰jYhjD]r3jbX --human-logr3…r3}r3(jIUjKNjXNjYhjJj3ubaubj»)r 3}r!3(jIX=pathjJj3jKjLjMj¾jO}r"3(j½j¾jT]jS]jQ]jR]jV]ujXM‰jYhjD]r#3jbX=pathr$3…r%3}r&3(jIUjKNjXNjYhjJj 3ubaubeubjÖ)r'3}r(3(jIUjJj 3jKjLjMjÙjO}r)3(jQ]jR]jS]jT]jV]ujXM‰jYhjD]r*3jy)r+3}r,3(jIX~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``.jJj'3jKjLjMj|jO}r-3(jQ]jR]jS]jT]jV]ujXMƒjYhjD]r.3(jbXLThe template used to name human-readable test logs; the path is relative to r/3…r03}r13(jIXLThe template used to name human-readable test logs; the path is relative to jKNjXNjYhjJj+3ubj‚)r23}r33(jIX ``dist/test``jO}r43(jQ]jR]jS]jT]jV]ujJj+3jD]r53jbX dist/testr63…r73}r83(jIUjJj23ubajMjŠubjbX7. By default, logs are named according to the template r93…r:3}r;3(jIX7. By default, logs are named according to the template jKNjXNjYhjJj+3ubj‚)r<3}r=3(jIX``$pkgid-$test-suite.log``jO}r>3(jQ]jR]jS]jT]jV]ujJj+3jD]r?3jbX$pkgid-$test-suite.logr@3…rA3}rB3(jIUjJj<3ubajMjŠubjbXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: rC3…rD3}rE3(jIXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: jKNjXNjYhjJj+3ubj‚)rF3}rG3(jIX ``$pkgid``jO}rH3(jQ]jR]jS]jT]jV]ujJj+3jD]rI3jbX$pkgidrJ3…rK3}rL3(jIUjJjF3ubajMjŠubjbX, rM3…rN3}rO3(jIX, rP3jKNjXNjYhjJj+3ubj‚)rQ3}rR3(jIX ``$compiler``jO}rS3(jQ]jR]jS]jT]jV]ujJj+3jD]rT3jbX $compilerrU3…rV3}rW3(jIUjJjQ3ubajMjŠubjbX, rX3…rY3}rZ3(jIX, jJj+3ubj‚)r[3}r\3(jIX``$os``jO}r]3(jQ]jR]jS]jT]jV]ujJj+3jD]r^3jbX$osr_3…r`3}ra3(jIUjJj[3ubajMjŠubjbX, rb3…rc3}rd3(jIX, jKNjXNjYhjJj+3ubj‚)re3}rf3(jIX ``$arch``jO}rg3(jQ]jR]jS]jT]jV]ujJj+3jD]rh3jbX$archri3…rj3}rk3(jIUjJje3ubajMjŠubjbX, rl3…rm3}rn3(jIX, jJj+3ubj‚)ro3}rp3(jIX``$abi``jO}rq3(jQ]jR]jS]jT]jV]ujJj+3jD]rr3jbX$abirs3…rt3}ru3(jIUjJjo3ubajMjŠubjbX, rv3…rw3}rx3(jIX, jJj+3ubj‚)ry3}rz3(jIX ``$abitag``jO}r{3(jQ]jR]jS]jT]jV]ujJj+3jD]r|3jbX$abitagr}3…r~3}r3(jIUjJjy3ubajMjŠubjbX, r€3…r3}r‚3(jIjP3jJj+3ubj‚)rƒ3}r„3(jIX``$test-suite``jO}r…3(jQ]jR]jS]jT]jV]ujJj+3jD]r†3jbX $test-suiter‡3…rˆ3}r‰3(jIUjJjƒ3ubajMjŠubjbX, and rŠ3…r‹3}rŒ3(jIX, and jKNjXNjYhjJj+3ubj‚)r3}rŽ3(jIX ``$result``jO}r3(jQ]jR]jS]jT]jV]ujJj+3jD]r3jbX$resultr‘3…r’3}r“3(jIUjJj3ubajMjŠubjbX.…r”3}r•3(jIX.jKNjXNjYhjJj+3ubeubaubeubj’)r–3}r—3(jIUjJj©2jKjLjMj•jO}r˜3(jT]jS]jQ]jR]jV]Uentries]r™3(j˜X2setup-test command line option; --machine-log=pathhÑUNtrš3aujXNjYhjD]ubjš)r›3}rœ3(jIUjJj©2jKjLjMjjO}r3(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrž3j£jž3ujXNjYhjD]rŸ3(j¥)r 3}r¡3(jIX--machine-log=pathjJj›3jKjLjMj¨jO}r¢3(jª]r£3X --machine-logr¤3ajT]r¥3hÑajS]jQ]jR]jV]r¦3h*aj°‰ujXMjYhjD]r§3(j²)r¨3}r©3(jIj¤3jJj 3jKjLjMjµjO}rª3(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r«3jbX --machine-logr¬3…r­3}r®3(jIUjKNjXNjYhjJj¨3ubaubj»)r¯3}r°3(jIX=pathjJj 3jKjLjMj¾jO}r±3(j½j¾jT]jS]jQ]jR]jV]ujXMjYhjD]r²3jbX=pathr³3…r´3}rµ3(jIUjKNjXNjYhjJj¯3ubaubeubjÖ)r¶3}r·3(jIUjJj›3jKjLjMjÙjO}r¸3(jQ]jR]jS]jT]jV]ujXMjYhjD]r¹3jy)rº3}r»3(jIXÞ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``.jJj¶3jKjLjMj|jO}r¼3(jQ]jR]jS]jT]jV]ujXMŒjYhjD]r½3(jbX2The path to the machine-readable log, relative to r¾3…r¿3}rÀ3(jIX2The path to the machine-readable log, relative to jKNjXNjYhjJjº3ubj‚)rÁ3}rÂ3(jIX ``dist/test``jO}rÃ3(jQ]jR]jS]jT]jV]ujJjº3jD]rÄ3jbX dist/testrÅ3…rÆ3}rÇ3(jIUjJjÁ3ubajMjŠubjbX. The default template is rÈ3…rÉ3}rÊ3(jIX. The default template is jKNjXNjYhjJjº3ubj‚)rË3}rÌ3(jIX``$pkgid.log``jO}rÍ3(jQ]jR]jS]jT]jV]ujJjº3jD]rÎ3jbX $pkgid.logrÏ3…rÐ3}rÑ3(jIUjJjË3ubajMjŠubjbX". Template variables allowed are: rÒ3…rÓ3}rÔ3(jIX". Template variables allowed are: jKNjXNjYhjJjº3ubj‚)rÕ3}rÖ3(jIX ``$pkgid``jO}r×3(jQ]jR]jS]jT]jV]ujJjº3jD]rØ3jbX$pkgidrÙ3…rÚ3}rÛ3(jIUjJjÕ3ubajMjŠubjbX, rÜ3…rÝ3}rÞ3(jIX, rß3jKNjXNjYhjJjº3ubj‚)rà3}rá3(jIX ``$compiler``jO}râ3(jQ]jR]jS]jT]jV]ujJjº3jD]rã3jbX $compilerrä3…rå3}ræ3(jIUjJjà3ubajMjŠubjbX, rç3…rè3}ré3(jIX, jJjº3ubj‚)rê3}rë3(jIX``$os``jO}rì3(jQ]jR]jS]jT]jV]ujJjº3jD]rí3jbX$osrî3…rï3}rð3(jIUjJjê3ubajMjŠubjbX, rñ3…rò3}ró3(jIX, jJjº3ubj‚)rô3}rõ3(jIX ``$arch``jO}rö3(jQ]jR]jS]jT]jV]ujJjº3jD]r÷3jbX$archrø3…rù3}rú3(jIUjJjô3ubajMjŠubjbX, rû3…rü3}rý3(jIX, jJjº3ubj‚)rþ3}rÿ3(jIX``$abi``jO}r4(jQ]jR]jS]jT]jV]ujJjº3jD]r4jbX$abir4…r4}r4(jIUjJjþ3ubajMjŠubjbX, r4…r4}r4(jIjß3jJjº3ubj‚)r4}r 4(jIX ``$abitag``jO}r 4(jQ]jR]jS]jT]jV]ujJjº3jD]r 4jbX$abitagr 4…r 4}r4(jIUjJj4ubajMjŠubjbX and r4…r4}r4(jIX and jKNjXNjYhjJjº3ubj‚)r4}r4(jIX ``$result``jO}r4(jQ]jR]jS]jT]jV]ujJjº3jD]r4jbX$resultr4…r4}r4(jIUjJj4ubajMjŠubjbX.…r4}r4(jIX.jKNjXNjYhjJjº3ubeubaubeubj’)r4}r4(jIUjJj©2jKjLjMj•jO}r4(jT]jS]jQ]jR]jV]Uentries]r4(j˜X5setup-test command line option; --show-details=filterhóUNtr4aujXNjYhjD]ubjš)r 4}r!4(jIUjJj©2jKjLjMjjO}r"4(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr#4j£j#4ujXNjYhjD]r$4(j¥)r%4}r&4(jIX--show-details=filterjJj 4jKjLjMj¨jO}r'4(jª]r(4X--show-detailsr)4ajT]r*4hóajS]jQ]jR]jV]r+4hMaj°‰ujXM—jYhjD]r,4(j²)r-4}r.4(jIj)4jJj%4jKjLjMjµjO}r/4(j½j¾jT]jS]jQ]jR]jV]ujXM—jYhjD]r04jbX--show-detailsr14…r24}r34(jIUjKNjXNjYhjJj-4ubaubj»)r44}r54(jIX=filterjJj%4jKjLjMj¾jO}r64(j½j¾jT]jS]jQ]jR]jV]ujXM—jYhjD]r74jbX=filterr84…r94}r:4(jIUjKNjXNjYhjJj44ubaubeubjÖ)r;4}r<4(jIUjJj 4jKjLjMjÙjO}r=4(jQ]jR]jS]jT]jV]ujXM—jYhjD]r>4jy)r?4}r@4(jIXá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).jJj;4jKjLjMj|jO}rA4(jQ]jR]jS]jT]jV]ujXM“jYhjD]rB4(jbXUDetermines if the results of individual test cases are shown on the terminal. May be rC4…rD4}rE4(jIXUDetermines if the results of individual test cases are shown on the terminal. May be jKNjXNjYhjJj?4ubj‚)rF4}rG4(jIX ``always``jO}rH4(jQ]jR]jS]jT]jV]ujJj?4jD]rI4jbXalwaysrJ4…rK4}rL4(jIUjJjF4ubajMjŠubjbX (always show), rM4…rN4}rO4(jIX (always show), jKNjXNjYhjJj?4ubj‚)rP4}rQ4(jIX ``never``jO}rR4(jQ]jR]jS]jT]jV]ujJj?4jD]rS4jbXneverrT4…rU4}rV4(jIUjJjP4ubajMjŠubjbX (never show), rW4…rX4}rY4(jIX (never show), jKNjXNjYhjJj?4ubj‚)rZ4}r[4(jIX ``failures``jO}r\4(jQ]jR]jS]jT]jV]ujJj?4jD]r]4jbXfailuresr^4…r_4}r`4(jIUjJjZ4ubajMjŠubjbX (show only failed results), or ra4…rb4}rc4(jIX (show only failed results), or jKNjXNjYhjJj?4ubj‚)rd4}re4(jIX ``streaming``jO}rf4(jQ]jR]jS]jT]jV]ujJj?4jD]rg4jbX streamingrh4…ri4}rj4(jIUjJjd4ubajMjŠubjbX! (show all results in real time).rk4…rl4}rm4(jIX! (show all results in real time).jKNjXNjYhjJj?4ubeubaubeubj’)rn4}ro4(jIUjJj©2jKNjMj•jO}rp4(jT]jS]jQ]jR]jV]Uentries]rq4((j˜X6setup-test command line option; --test-options=optionshÄUNtrr4(j˜XKsetup-test command line option; Give extra options to the test executables.j=UNtrs4eujXNjYhjD]ubjš)rt4}ru4(jIUjJj©2jKNjMjjO}rv4(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionrw4j£jw4ujXNjYhjD]rx4(j¥)ry4}rz4(jIX--test-options=optionsjJjt4jKjLjMj¨jO}r{4(jª]r|4X--test-optionsr}4ajT]r~4hÄajS]jQ]jR]jV]r4haj°‰ujXMšjYhjD]r€4(j²)r4}r‚4(jIj}4jJjy4jKjLjMjµjO}rƒ4(j½j¾jT]jS]jQ]jR]jV]ujXMšjYhjD]r„4jbX--test-optionsr…4…r†4}r‡4(jIUjKNjXNjYhjJj4ubaubj»)rˆ4}r‰4(jIX=optionsjJjy4jKjLjMj¾jO}rŠ4(j½j¾jT]jS]jQ]jR]jV]ujXMšjYhjD]r‹4jbX=optionsrŒ4…r4}rŽ4(jIUjKNjXNjYhjJjˆ4ubaubeubj¥)r4}r4(jIX+Give extra options to the test executables.jJjt4jKjLjMj¨jO}r‘4(jª]r’4XGiver“4ajT]r”4j=ajS]jQ]jR]jV]r•4haj°‰ujXMšjYhjD]r–4(j²)r—4}r˜4(jIj“4jJj4jKjLjMjµjO}r™4(j½j¾jT]jS]jQ]jR]jV]ujXMšjYhjD]rš4jbXGiver›4…rœ4}r4(jIUjKNjXNjYhjJj—4ubaubj»)rž4}rŸ4(jIX' extra options to the test executables.jJj4jKjLjMj¾jO}r 4(j½j¾jT]jS]jQ]jR]jV]ujXMšjYhjD]r¡4jbX' extra options to the test executables.r¢4…r£4}r¤4(jIUjKNjXNjYhjJjž4ubaubeubjÖ)r¥4}r¦4(jIUjJjt4jKjLjMjÙjO}r§4(jQ]jR]jS]jT]jV]ujXMšjYhjD]ubeubj’)r¨4}r©4(jIUjJj©2jKjLjMj•jO}rª4(jT]jS]jQ]jR]jV]Uentries]r«4(j˜X4setup-test command line option; --test-option=optionh¸UNtr¬4aujXNjYhjD]ubjš)r­4}r®4(jIUjJj©2jKjLjMjjO}r¯4(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr°4j£j°4ujXNjYhjD]r±4(j¥)r²4}r³4(jIX--test-option=optionjJj­4jKjLjMj¨jO}r´4(jª]rµ4X --test-optionr¶4ajT]r·4h¸ajS]jQ]jR]jV]r¸4haj°‰ujXM jYhjD]r¹4(j²)rº4}r»4(jIj¶4jJj²4jKjLjMjµjO}r¼4(j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]r½4jbX --test-optionr¾4…r¿4}rÀ4(jIUjKNjXNjYhjJjº4ubaubj»)rÁ4}rÂ4(jIX=optionjJj²4jKjLjMj¾jO}rÃ4(j½j¾jT]jS]jQ]jR]jV]ujXM jYhjD]rÄ4jbX=optionrÅ4…rÆ4}rÇ4(jIUjKNjXNjYhjJjÁ4ubaubeubjÖ)rÈ4}rÉ4(jIUjJj­4jKjLjMjÙjO}rÊ4(jQ]jR]jS]jT]jV]ujXM jYhjD]rË4jy)rÌ4}rÍ4(jIX­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Î4jJjÈ4jKjLjMj|jO}rÏ4(jQ]jR]jS]jT]jV]ujXMjYhjD]rÐ4jbX­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Ñ4…rÒ4}rÓ4(jIjÎ4jKNjXNjYhjJjÌ4ubaubaubeubjá)rÔ4}rÕ4(jIX.. _setup-sdist:jJj©2jKjLjMjäjO}rÖ4(jT]jS]jQ]jR]jV]jæhèujXM¡jYhjD]ubeubjF)r×4}rØ4(jIUjJjçjKjLjé}rÙ4hAjÔ4sjMjNjO}rÚ4(jQ]jR]jS]jT]rÛ4(hèj?ejV]rÜ4(hŸhAeujXM¤jYhjî}rÝ4hèjÔ4sjD]rÞ4(j[)rß4}rà4(jIX setup sdistrá4jJj×4jKjLjMj_jO}râ4(jQ]jR]jS]jT]jV]ujXM¤jYhjD]rã4jbX setup sdisträ4…rå4}ræ4(jIjá4jKNjXNjYhjJjß4ubaubjy)rç4}rè4(jIXò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.jJj×4jKjLjMj|jO}ré4(jQ]jR]jS]jT]jV]ujXM¦jYhjD]rê4(jbXHCreate a system- and compiler-independent source distribution in a file rë4…rì4}rí4(jIXHCreate a system- and compiler-independent source distribution in a file jKNjXNjYhjJjç4ubj½)rî4}rï4(jIX *package*jO}rð4(jQ]jR]jS]jT]jV]ujJjç4jD]rñ4jbXpackagerò4…ró4}rô4(jIUjJjî4ubajMjÅubjbX-…rõ4}rö4(jIX-jKNjXNjYhjJjç4ubj½)r÷4}rø4(jIX *version*jO}rù4(jQ]jR]jS]jT]jV]ujJjç4jD]rú4jbXversionrû4…rü4}rý4(jIUjJj÷4ubajMjÅubjbX…rþ4}rÿ4(jIX\ jKNjXNjYhjJjç4ubj‚)r5}r5(jIX ``.tar.gz``jO}r5(jQ]jR]jS]jT]jV]ujJjç4jD]r5jbX.tar.gzr5…r5}r5(jIUjJj5ubajMjŠubjbX in the r5…r5}r 5(jIX in the jKNjXNjYhjJjç4ubj‚)r 5}r 5(jIX``dist``jO}r 5(jQ]jR]jS]jT]jV]ujJjç4jD]r 5jbXdistr5…r5}r5(jIUjJj 5ubajMjŠubjbXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.r5…r5}r5(jIXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.jKNjXNjYhjJjç4ubeubjy)r5}r5(jIXYThe 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``, ``asm-sources``, ``cmm-sources``, ``js-sources``, ``data-files``, ``extra-source-files`` and ``extra-doc-files`` fields.jJj×4jKjLjMj|jO}r5(jQ]jR]jS]jT]jV]ujXM«jYhjD]r5(jbX³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 r5…r5}r5(jIX³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 jKNjXNjYhjJj5ubj‚)r5}r5(jIX``license-file``jO}r5(jQ]jR]jS]jT]jV]ujJj5jD]r5jbX license-filer5…r 5}r!5(jIUjJj5ubajMjŠubjbX, r"5…r#5}r$5(jIX, r%5jKNjXNjYhjJj5ubj‚)r&5}r'5(jIX ``main-is``jO}r(5(jQ]jR]jS]jT]jV]ujJj5jD]r)5jbXmain-isr*5…r+5}r,5(jIUjJj&5ubajMjŠubjbX, r-5…r.5}r/5(jIX, r05jKNjXNjYhjJj5ubj‚)r15}r25(jIX ``c-sources``jO}r35(jQ]jR]jS]jT]jV]ujJj5jD]r45jbX c-sourcesr55…r65}r75(jIUjJj15ubajMjŠubjbX, r85…r95}r:5(jIX, jJj5ubj‚)r;5}r<5(jIX``asm-sources``jO}r=5(jQ]jR]jS]jT]jV]ujJj5jD]r>5jbX asm-sourcesr?5…r@5}rA5(jIUjJj;5ubajMjŠubjbX, rB5…rC5}rD5(jIX, jJj5ubj‚)rE5}rF5(jIX``cmm-sources``jO}rG5(jQ]jR]jS]jT]jV]ujJj5jD]rH5jbX cmm-sourcesrI5…rJ5}rK5(jIUjJjE5ubajMjŠubjbX, rL5…rM5}rN5(jIX, jJj5ubj‚)rO5}rP5(jIX``js-sources``jO}rQ5(jQ]jR]jS]jT]jV]ujJj5jD]rR5jbX js-sourcesrS5…rT5}rU5(jIUjJjO5ubajMjŠubjbX, rV5…rW5}rX5(jIj05jJj5ubj‚)rY5}rZ5(jIX``data-files``jO}r[5(jQ]jR]jS]jT]jV]ujJj5jD]r\5jbX data-filesr]5…r^5}r_5(jIUjJjY5ubajMjŠubjbX, r`5…ra5}rb5(jIj%5jJj5ubj‚)rc5}rd5(jIX``extra-source-files``jO}re5(jQ]jR]jS]jT]jV]ujJj5jD]rf5jbXextra-source-filesrg5…rh5}ri5(jIUjJjc5ubajMjŠubjbX and rj5…rk5}rl5(jIX and jKNjXNjYhjJj5ubj‚)rm5}rn5(jIX``extra-doc-files``jO}ro5(jQ]jR]jS]jT]jV]ujJj5jD]rp5jbXextra-doc-filesrq5…rr5}rs5(jIUjJjm5ubajMjŠubjbX fields.rt5…ru5}rv5(jIX fields.jKNjXNjYhjJj5ubeubjy)rw5}rx5(jIX(This command takes the following option:ry5jJj×4jKjLjMj|jO}rz5(jQ]jR]jS]jT]jV]ujXM±jYhjD]r{5jbX(This command takes the following option:r|5…r}5}r~5(jIjy5jKNjXNjYhjJjw5ubaubj’)r5}r€5(jIUjJj×4jKjLjMj•jO}r5(jT]jS]jQ]jR]jV]Uentries]r‚5(j˜X+setup-sdist command line option; --snapshothÐUNtrƒ5aujXNjYhjD]ubjš)r„5}r…5(jIUjJj×4jKjLjMjjO}r†5(jŸ‰j XstdjT]jS]jQ]jR]jV]j¡Xoptionr‡5j£j‡5ujXNjYhjD]rˆ5(j¥)r‰5}rŠ5(jIX --snapshotr‹5jJj„5jKjLjMj¨jO}rŒ5(jª]r5j‹5ajT]rŽ5hÐajS]jQ]jR]jV]r5h)aj°‰ujXMºjYhjD]r5(j²)r‘5}r’5(jIj‹5jJj‰5jKjLjMjµjO}r“5(j½j¾jT]jS]jQ]jR]jV]ujXMºjYhjD]r”5jbX --snapshotr•5…r–5}r—5(jIUjKNjXNjYhjJj‘5ubaubj»)r˜5}r™5(jIUjJj‰5jKjLjMj¾jO}rš5(j½j¾jT]jS]jQ]jR]jV]ujXMºjYhjD]ubeubjÖ)r›5}rœ5(jIUjJj„5jKjLjMjÙjO}r5(jQ]jR]jS]jT]jV]ujXMºjYhjD]rž5jy)rŸ5}r 5(jIX†Append today's date (in "YYYYMMDD" format) to the version number for the generated source package. The original package is unaffected.r¡5jJj›5jKjLjMj|jO}r¢5(jQ]jR]jS]jT]jV]ujXM·jYhjD]r£5jbXŒAppend today’s date (in “YYYYMMDD†format) to the version number for the generated source package. The original package is unaffected.r¤5…r¥5}r¦5(jIj¡5jKNjXNjYhjJjŸ5ubaubaubeubj¥*)r§5}r¨5(jIX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyjJj×4jKcdocutils.nodes reprunicode r©5Xdoc/references.incrª5…r«5}r¬5bjMj¨*jO}r­5(j½j¾jT]jS]jQ]jR]jV]ujXKjYhjD]r®5jbX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyr¯5…r°5}r±5(jIUjJj§5ubaubjá)r²5}r³5(jIX .. _`Package Versioning Policy`:jJj×4jKj«5jMjäjO}r´5(jT]jS]jQ]jR]jV]jæj(ujXMÁjYhjD]ubjá)rµ5}r¶5(jIX .. _PVP: http://pvp.haskell.org/jJj×4jKj«5jé}r·5h‡j²5sjMjäjO}r¸5(jêXhttp://pvp.haskell.org/jT]r¹5(hòj(ejS]jQ]jR]jV]rº5(hLh‡eujXMÂjYhjî}r»5j(j²5sjD]ubjá)r¼5}r½5(jIX(.. _Hackage: http://hackage.haskell.org/jfKjJj×4jKj«5jMjäjO}r¾5(jêjëjT]r¿5jCajS]jQ]jR]jV]rÀ5h£aujXMÄjYhjD]ubjá)rÁ5}rÂ5(jIX$.. _Haskell: http://www.haskell.org/jJj×4jKj«5jMjäjO}rÃ5(jêXhttp://www.haskell.org/jT]rÄ5jajS]jQ]jR]jV]rÅ5h_aujXMÆjYhjD]ubjá)rÆ5}rÇ5(jIX,.. _Haddock: http://www.haskell.org/haddock/jfKjJj×4jKj«5jMjäjO}rÈ5(jêjÏ+jT]rÉ5j ajS]jQ]jR]jV]rÊ5h}aujXMÈjYhjD]ubjá)rË5}rÌ5(jIX&.. _Alex: http://www.haskell.org/alex/jJj×4jKj«5jMjäjO}rÍ5(jêXhttp://www.haskell.org/alex/jT]rÎ5hôajS]jQ]jR]jV]rÏ5hNaujXMÊjYhjD]ubjá)rÐ5}rÑ5(jIX(.. _Happy: http://www.haskell.org/happy/jJj×4jKj«5jMjäjO}rÒ5(jêXhttp://www.haskell.org/happy/jT]rÓ5jajS]jQ]jR]jV]rÔ5hnaujXMÌjYhjD]ubjá)rÕ5}rÖ5(jIX*.. _Hoogle: http://www.haskell.org/hoogle/jfKjJj×4jKj«5jMjäjO}r×5(jêjK,jT]rØ5jajS]jQ]jR]jV]rÙ5haaujXMÎjYhjD]ubjá)rÚ5}rÛ5(jIX9.. _HsColour: http://www.cs.york.ac.uk/fp/darcs/hscolour/jfKjJj×4jKj«5jMjäjO}rÜ5(jêjÁ-jT]rÝ5hãajS]jQ]jR]jV]rÞ5h6(jQ]jR]jS]jT]jV]ujJj86jD]r?6jbX3Hyperlink target "setup-install" is not referenced.r@6…rA6}rB6(jIUjJj<6ubajMj|ubajMj 6ubjþ5)rC6}rD6(jIUjO}rE6(jQ]UlevelKjT]jS]UsourcejLjR]jV]UlineMòUtypej6ujD]rF6jy)rG6}rH6(jIUjO}rI6(jQ]jR]jS]jT]jV]ujJjC6jD]rJ6jbX0Hyperlink target "setup-copy" is not referenced.rK6…rL6}rM6(jIUjJjG6ubajMj|ubajMj 6ubjþ5)rN6}rO6(jIUjO}rP6(jQ]UlevelKjT]jS]UsourcejLjR]jV]UlineMUtypej6ujD]rQ6jy)rR6}rS6(jIUjO}rT6(jQ]jR]jS]jT]jV]ujJjN6jD]rU6jbX4Hyperlink target "setup-register" is not referenced.rV6…rW6}rX6(jIUjJjR6ubajMj|ubajMj 6ubjþ5)rY6}rZ6(jIUjO}r[6(jQ]UlevelKjT]jS]UsourcejLjR]jV]UlineMDUtypej6ujD]r\6jy)r]6}r^6(jIUjO}r_6(jQ]jR]jS]jT]jV]ujJjY6jD]r`6jbX6Hyperlink target "setup-unregister" is not referenced.ra6…rb6}rc6(jIUjJj]6ubajMj|ubajMj 6ubjþ5)rd6}re6(jIUjO}rf6(jQ]UlevelKjT]jS]UsourcejLjR]jV]UlineM_Utypej6ujD]rg6jy)rh6}ri6(jIUjO}rj6(jQ]jR]jS]jT]jV]ujJjd6jD]rk6jbX1Hyperlink target "setup-clean" is not referenced.rl6…rm6}rn6(jIUjJjh6ubajMj|ubajMj 6ubjþ5)ro6}rp6(jIUjO}rq6(jQ]UlevelKjT]jS]UsourcejLjR]jV]UlineM¡Utypej6ujD]rr6jy)rs6}rt6(jIUjO}ru6(jQ]jR]jS]jT]jV]ujJjo6jD]rv6jbX1Hyperlink target "setup-sdist" is not referenced.rw6…rx6}ry6(jIUjJjs6ubajMj|ubajMj 6ubjþ5)rz6}r{6(jIUjO}r|6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÁUtypej6ujD]r}6jy)r~6}r6(jIUjO}r€6(jQ]jR]jS]jT]jV]ujJjz6jD]r6jbX?Hyperlink target "package-versioning-policy" is not referenced.r‚6…rƒ6}r„6(jIUjJj~6ubajMj|ubajMj 6ubjþ5)r…6}r†6(jIUjO}r‡6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÂUtypej6ujD]rˆ6jy)r‰6}rŠ6(jIUjO}r‹6(jQ]jR]jS]jT]jV]ujJj…6jD]rŒ6jbX)Hyperlink target "pvp" is not referenced.r6…rŽ6}r6(jIUjJj‰6ubajMj|ubajMj 6ubjþ5)r6}r‘6(jIUjO}r’6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÆUtypej6ujD]r“6jy)r”6}r•6(jIUjO}r–6(jQ]jR]jS]jT]jV]ujJj6jD]r—6jbX-Hyperlink target "haskell" is not referenced.r˜6…r™6}rš6(jIUjJj”6ubajMj|ubajMj 6ubjþ5)r›6}rœ6(jIUjO}r6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÊUtypej6ujD]rž6jy)rŸ6}r 6(jIUjO}r¡6(jQ]jR]jS]jT]jV]ujJj›6jD]r¢6jbX*Hyperlink target "alex" is not referenced.r£6…r¤6}r¥6(jIUjJjŸ6ubajMj|ubajMj 6ubjþ5)r¦6}r§6(jIUjO}r¨6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÌUtypej6ujD]r©6jy)rª6}r«6(jIUjO}r¬6(jQ]jR]jS]jT]jV]ujJj¦6jD]r­6jbX+Hyperlink target "happy" is not referenced.r®6…r¯6}r°6(jIUjJjª6ubajMj|ubajMj 6ubjþ5)r±6}r²6(jIUjO}r³6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÒUtypej6ujD]r´6jy)rµ6}r¶6(jIUjO}r·6(jQ]jR]jS]jT]jV]ujJj±6jD]r¸6jbX+Hyperlink target "cpphs" is not referenced.r¹6…rº6}r»6(jIUjJjµ6ubajMj|ubajMj 6ubjþ5)r¼6}r½6(jIUjO}r¾6(jQ]UlevelKjT]jS]Usourcej«5jR]jV]UlineMÔUtypej6ujD]r¿6jy)rÀ6}rÁ6(jIUjO}rÂ6(jQ]jR]jS]jT]jV]ujJj¼6jD]rÃ6jbX*Hyperlink target "abnf" is not referenced.rÄ6…rÅ6}rÆ6(jIUjJjÀ6ubajMj|ubajMj 6ubeUreporterrÇ6NUid_startrÈ6K U autofootnotesrÉ6]rÊ6U citation_refsrË6}rÌ6Uindirect_targetsrÍ6]rÎ6UsettingsrÏ6(cdocutils.frontend Values rÐ6orÑ6}rÒ6(Ufootnote_backlinksrÓ6KUrecord_dependenciesrÔ6NU language_coderÕ6UenrÖ6U tracebackr×6ˆUpep_referencesrØ6NUstrip_commentsrÙ6NU toc_backlinksrÚ6j™U rfc_base_urlrÛ6Uhttps://tools.ietf.org/html/rÜ6U datestamprÝ6NU report_levelrÞ6KUsmartquotes_localesrß6NU _destinationrà6NU halt_levelrá6KU strip_classesrâ6Nj_NUerror_encoding_error_handlerrã6Ubackslashreplacerä6Udebugrå6NUembed_stylesheetræ6‰Uoutput_encoding_error_handlerrç6Ustrictrè6U sectnum_xformré6KUdump_transformsrê6NU docinfo_xformrë6KUwarning_streamrì6NUpep_file_url_templaterí6Upep-%04drî6Uexit_status_levelrï6KUconfigrð6NUstrict_visitorrñ6NUcloak_email_addressesrò6ˆUtrim_footnote_reference_spaceró6‰Uenvrô6NUdump_pseudo_xmlrõ6NUexpose_internalsrö6NUsectsubtitle_xformr÷6‰U source_linkrø6NUrfc_referencesrù6NUoutput_encodingrú6Uutf-8rû6U source_urlrü6NUinput_encodingrý6U utf-8-sigrþ6U_disable_configrÿ6NU id_prefixr7UUcharacter_level_inline_markupr7‰U tab_widthr7KUerror_encodingr7UUTF-8r7U_sourcer7jLUgettext_compactr7ˆU generatorr7NUdump_internalsr7NU smart_quotesr 7ˆU pep_base_urlr 7U https://www.python.org/dev/peps/r 7Usyntax_highlightr 7Ulongr 7Uinput_encoding_error_handlerr7jè6Uauto_id_prefixr7Uidr7Udoctitle_xformr7‰Ustrip_elements_with_classesr7NU _config_filesr7]Ufile_insertion_enabledr7ˆU raw_enabledr7KU dump_settingsr7NubUsymbol_footnote_startr7KUidsr7}r7(hßjŸ(hÖjDhñjØ#jjP&j1jµ+h°j\1hÓjRh´j 2hØj½ hµjµ+h®jë*hájj>j±'hÐj‰5jj„ j2j%hÂjÚ$hÅjÛ)j9j³j=j4jjZj'j–0hÀjZ"hÈjG+hôjË5h½jçhËjØ!jAjîj$jÇj jôhÿj†1hòjµ5j0j¸ h·jq+hÛjljj hýj)hâj.hÑj 3hãjÚ5häj/jjH!jjn0hèj×4j,j\1h¿j/j+jÄ/hîjî/j#j-.hêj/j;jG+hÕjŸj&jdj-jòj(jµ5jjˆ/højß5hÜj†hÍj‘h¾j®1h¼jy$hæjŽ hüj©2hÞj,hÙjòjj@j7jØ,håj¦hçjÖ1jjÁ5jjn jjtj)jF0híjN-j j@$jjkhìjí%jj0hújç-hùj*'jjÕ5h×j-hëj°!hûjÃ&höjGj jä5h±j® jgjbjj+1j?j×4hºjÒ.j/jT(hÁj:jjD/h¹jÌj*jÅ%jjÐ5jjÜh²jÛhÔj (h¸j²4j"jx&h¯j²$jjdhój%4hðjÒ2j jÆ5hÝj©j.jj3j&hàjÂ"h»jªjj2"hÇjy2hÉj›h³j3hÎjq hþjÑ0jjê"jjõ hõj‡hÆj%jj|.j4j-.hÒj !jjQj!jq,jj`j6jçhÚj·j%j—-hÄjy4j8j¾jj hïj¿*j:jîhÏj…'hÃjoh÷jd%jj j5j h¶j¸j j 2hÌj héjKj jë&j@jÄ/h­jÔ hÊj0jBjçjCj¼5j<j3%uUsubstitution_namesr7}r7jMjYjO}r7(jQ]jT]jS]UsourcejLjR]jV]uU footnotesr7]r7Urefidsr7}r 7(hµ]r!7j²+aj]r"7jaahè]r#7jÔ4aj6]r$7jâaj(]r%7j²5aj]r&7j0ah°]r'7jY1aj@]r(7jÁ/ah´]r)7j2ahÈ]r*7jD+ahä]r+7jý.aj4]r,7j*.auub.