€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–ˆXbgnu autoconf places restrictions on paths, including the directory that the package is built from.q—ˆ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-globalrhZUoverviewrh[U+cmdoption-setup-configure-disable-profilingrh\Usetup-registerrh]Uinstallation-pathsrh^Ucmdoption-setup-install-globalrh_Uhaskellrh`U$cmdoption-setup-configure-datasubdirrhaUhooglerhbUcmdoption-setup-configure-ipidr hcU$cmdoption-setup-configure-package-dbr hdUid9r heU*cmdoption-setup-configure-configure-optionr hfUabnfr hgU0cmdoption-setup-configure-enable-library-vanillarhhU*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-libsubdirr h}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-configurationr0hU#cmdoption-setup-configure-with-progr1hhæh‘Uid3r2h’U6cmdoption-setup-configure-disable-executable-strippingr3h“U'cmdoption-setup-configure-enable-staticr4h”Usetup-hscolourr5h•U cmdoption-setup-configure-prefixr6h–Uinstalling-packagesr7h—U`gnu-autoconf-places-restrictions-on-paths-including-the-directory-that-the-package-is-built-fromr8h˜U#cmdoption-setup-haddock-executablesr9h™Ucontrolling-flag-assignmentsr:hšU&cmdoption-setup-configure-enable-testsr;h›U'cmdoption-setup-configure-disable-testsr<hœUid2r=hU,cmdoption-setup-configure-disable-split-objsr>hžUcmdoption-setup-test-arg-giver?hŸU.cmdoption-setup-configure-extra-framework-dirsr@h Uid10rAh¡U setup-copyrBh¢Ucmdoption-setup-verboserCh£Ucmdoption-setup-configure-frDh¤UhackagerEuUchildrenrF]rG(cdocutils.nodes section rH)rI}rJ(U rawsourcerKUUparentrLhUsourcerMXE/home/refold/code/haskell/cabal-2.4/Cabal/doc/installing-packages.rstrNUtagnamerOUsectionrPU attributesrQ}rR(UdupnamesrS]UclassesrT]UbackrefsrU]UidsrV]rWh÷aUnamesrX]rYhPauUlinerZKUdocumentr[hjF]r\(cdocutils.nodes title r])r^}r_(jKX Configurationr`jLjIjMjNjOUtitlerajQ}rb(jS]jT]jU]jV]jX]ujZKj[hjF]rccdocutils.nodes Text rdX Configurationre…rf}rg(jKj`jMNjZNj[hjLj^ubaubcsphinx.addnodes highlightlang rh)ri}rj(jKUjLjIjMjNjOU highlightlangrkjQ}rl(UlangXcabalUlinenothresholdI9223372036854775807 jV]jU]jS]jT]jX]ujZKj[hjF]ubjH)rm}rn(jKUjLjIjMjNjOjPjQ}ro(jS]jT]jU]jV]rpjajX]rqhZaujZKj[hjF]rr(j])rs}rt(jKXOverviewrujLjmjMjNjOjajQ}rv(jS]jT]jU]jV]jX]ujZKj[hjF]rwjdXOverviewrx…ry}rz(jKjujMNjZNj[hjLjsubaubcdocutils.nodes paragraph r{)r|}r}(jKXü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 usingjLjmjMjNjOU paragraphr~jQ}r(jS]jT]jU]jV]jX]ujZK j[hjF]r€(jdX"The global configuration file for r…r‚}rƒ(jKX"The global configuration file for jMNjZNj[hjLj|ubcdocutils.nodes literal r„)r…}r†(jKX``cabal-install``jQ}r‡(jS]jT]jU]jV]jX]ujLj|jF]rˆjdX cabal-installr‰…rŠ}r‹(jKUjLj…ubajOUliteralrŒubjdX is r…rŽ}r(jKX is jMNjZNj[hjLj|ubj„)r}r‘(jKX``~/.cabal/config``jQ}r’(jS]jT]jU]jV]jX]ujLj|jF]r“jdX~/.cabal/configr”…r•}r–(jKUjLjubajOjŒubjdX . If you do not have this file, r—…r˜}r™(jKX . If you do not have this file, jMNjZNj[hjLj|ubj„)rš}r›(jKX ``cabal``jQ}rœ(jS]jT]jU]jV]jX]ujLj|jF]rjdXcabalrž…rŸ}r (jKUjLjšubajOjŒubjdX- will create it for you on the first call to r¡…r¢}r£(jKX- will create it for you on the first call to jMNjZNj[hjLj|ubj„)r¤}r¥(jKX``cabal update``jQ}r¦(jS]jT]jU]jV]jX]ujLj|jF]r§jdX cabal updater¨…r©}rª(jKUjLj¤ubajOjŒubjdX(. Alternatively, you can explicitly ask r«…r¬}r­(jKX(. Alternatively, you can explicitly ask jMNjZNj[hjLj|ubj„)r®}r¯(jKX ``cabal``jQ}r°(jS]jT]jU]jV]jX]ujLj|jF]r±jdXcabalr²…r³}r´(jKUjLj®ubajOjŒubjdX to create it for you usingrµ…r¶}r·(jKX to create it for you usingjMNjZNj[hjLj|ubeubcdocutils.nodes literal_block r¸)r¹}rº(jKX$ cabal user-config updatejLjmjMjNjOU literal_blockr»jQ}r¼(Ulinenosr½‰Ulanguager¾XconsoleU xml:spacer¿UpreserverÀjV]jU]jS]Uhighlight_argsrÁ}jT]jX]ujZKj[hjF]rÂjdX$ cabal user-config updaterÃ…rÄ}rÅ(jKUjLj¹ubaubj{)rÆ}rÇ(jKXDMost 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ÈjLjmjMjNjOj~jQ}rÉ(jS]jT]jU]jV]jX]ujZKj[hjF]rÊjdXDMost 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Í(jKjÈjMNjZNj[hjLjÆubaubj¸)rÎ}rÏ(jKX-- executable-stripping: TruejLjmjMjNjOj»jQ}rÐ(j¿jÀjV]jU]jS]jT]jX]ujZKj[hjF]rÑjdX-- executable-stripping: TruerÒ…rÓ}rÔ(jKUjLjÎubaubj{)rÕ}rÖ(jKXmeans 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 tojLjmjMjNjOj~jQ}r×(jS]jT]jU]jV]jX]ujZKj[hjF]rØ(jdXMmeans that the configuration file currently does not specify a value for the rÙ…rÚ}rÛ(jKXMmeans that the configuration file currently does not specify a value for the jMNjZNj[hjLjÕubj„)rÜ}rÝ(jKX``executable-stripping``jQ}rÞ(jS]jT]jU]jV]jX]ujLjÕjF]rßjdXexecutable-strippingrà…rá}râ(jKUjLjÜubajOjŒubjdX= option (the line is commented out), and that the default is rã…rä}rå(jKX= option (the line is commented out), and that the default is jMNjZNj[hjLjÕubj„)ræ}rç(jKX``True``jQ}rè(jS]jT]jU]jV]jX]ujLjÕjF]réjdXTruerê…rë}rì(jKUjLjæubajOjŒubjdX]; if you wanted to disable stripping of executables by default, you would change this line torí…rî}rï(jKX]; if you wanted to disable stripping of executables by default, you would change this line tojMNjZNj[hjLjÕubeubj¸)rð}rñ(jKXexecutable-stripping: FalsejLjmjMjNjOj»jQ}rò(j¿jÀjV]jU]jS]jT]jX]ujZK#j[hjF]rójdXexecutable-stripping: Falserô…rõ}rö(jKUjLjðubaubj{)r÷}rø(jKXtYou can also use ``cabal user-config update`` to migrate configuration files created by older versions of ``cabal``.jLjmjMjNjOj~jQ}rù(jS]jT]jU]jV]jX]ujZK%j[hjF]rú(jdXYou can also use rû…rü}rý(jKXYou can also use jMNjZNj[hjLj÷ubj„)rþ}rÿ(jKX``cabal user-config update``jQ}r(jS]jT]jU]jV]jX]ujLj÷jF]rjdXcabal user-config updater…r}r(jKUjLjþubajOjŒubjdX= to migrate configuration files created by older versions of r…r}r(jKX= to migrate configuration files created by older versions of jMNjZNj[hjLj÷ubj„)r}r (jKX ``cabal``jQ}r (jS]jT]jU]jV]jX]ujLj÷jF]r jdXcabalr …r }r(jKUjLjubajOjŒubjdX.…r}r(jKX.jMNjZNj[hjLj÷ubeubeubjH)r}r(jKUjLjIjMjNjOjPjQ}r(jS]jT]jU]jV]rhâajX]rh:aujZK)j[hjF]r(j])r}r(jKXRepository specificationrjLjjMjNjOjajQ}r(jS]jT]jU]jV]jX]ujZK)j[hjF]rjdXRepository specificationr…r}r(jKjjMNjZNj[hjLjubaubj{)r}r (jKX»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:jLjjMjNjOj~jQ}r!(jS]jT]jU]jV]jX]ujZK+j[hjF]r"(jdXTAn important part of the configuration if the specification of the repository. When r#…r$}r%(jKXTAn important part of the configuration if the specification of the repository. When jMNjZNj[hjLjubj„)r&}r'(jKX ``cabal``jQ}r((jS]jT]jU]jV]jX]ujLjjF]r)jdXcabalr*…r+}r,(jKUjLj&ubajOjŒubjdX^ creates a default config file, it configures the repository to be the central Hackage server:r-…r.}r/(jKX^ creates a default config file, it configures the repository to be the central Hackage server:jMNjZNj[hjLjubeubj¸)r0}r1(jKXArepository hackage.haskell.org url: http://hackage.haskell.org/jLjjMjNjOj»jQ}r2(j¿jÀjV]jU]jS]jT]jX]ujZK1j[hjF]r3jdXArepository hackage.haskell.org url: http://hackage.haskell.org/r4…r5}r6(jKUjLj0ubaubj{)r7}r8(jKX¦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.jLjjMjNjOj~jQ}r9(jS]jT]jU]jV]jX]ujZK4j[hjF]r:(jdXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under r;…r<}r=(jKXŠThe name of the repository is given on the first line, and can be anything; packages downloaded from this repository will be cached under jMNjZNj[hjLj7ubj„)r>}r?(jKX)``~/.cabal/packages/hackage.haskell.org``jQ}r@(jS]jT]jU]jV]jX]ujLj7jF]rAjdX%~/.cabal/packages/hackage.haskell.orgrB…rC}rD(jKUjLj>ubajOjŒubjdXS (or whatever name you specify; you can change the prefix by changing the value of rE…rF}rG(jKXS (or whatever name you specify; you can change the prefix by changing the value of jMNjZNj[hjLj7ubj„)rH}rI(jKX``remote-repo-cache``jQ}rJ(jS]jT]jU]jV]jX]ujLj7jF]rKjdXremote-repo-cacherL…rM}rN(jKUjLjHubajOjŒubjdX=). If you want, you can configure multiple repositories, and rO…rP}rQ(jKX=). If you want, you can configure multiple repositories, and jMNjZNj[hjLj7ubj„)rR}rS(jKX ``cabal``jQ}rT(jS]jT]jU]jV]jX]ujLj7jF]rUjdXcabalrV…rW}rX(jKUjLjRubajOjŒubjdXE will combine them and be able to download packages from any of them.rY…rZ}r[(jKXE will combine them and be able to download packages from any of them.jMNjZNj[hjLj7ubeubjH)r\}r](jKUjLjjMjNjOjPjQ}r^(jS]jT]jU]jV]r_jajX]r`hiaujZK=j[hjF]ra(j])rb}rc(jKXUsing secure repositoriesrdjLj\jMjNjOjajQ}re(jS]jT]jU]jV]jX]ujZK=j[hjF]rfjdXUsing secure repositoriesrg…rh}ri(jKjdjMNjZNj[hjLjbubaubj{)rj}rk(jKX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:rljLj\jMjNjOj~jQ}rm(jS]jT]jU]jV]jX]ujZK?j[hjF]rnjdX”For repositories that support the TUF security infrastructure (this includes Hackage), you can enable secure access to the repository by specifying:ro…rp}rq(jKjljMNjZNj[hjLjjubaubj¸)rr}rs(jKXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: jLj\jMjNjOj»jQ}rt(j¿jÀjV]jU]jS]jT]jX]ujZKEj[hjF]rujdXrepository hackage.haskell.org url: http://hackage.haskell.org/ secure: True root-keys: key-threshold: rv…rw}rx(jKUjLjrubaubj{)ry}rz(jKXEThe ```` 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 ````.jLj\jMjNjOj~jQ}r{(jS]jT]jU]jV]jX]ujZKKj[hjF]r|(jdXThe r}…r~}r(jKXThe jMNjZNj[hjLjyubj„)r€}r(jKX````jQ}r‚(jS]jT]jU]jV]jX]ujLjyjF]rƒjdXr„…r…}r†(jKUjLj€ubajOjŒubjdX and r‡…rˆ}r‰(jKX and jMNjZNj[hjLjyubj„)rŠ}r‹(jKX````jQ}rŒ(jS]jT]jU]jV]jX]ujLjyjF]rjdXrŽ…r}r(jKUjLjŠubajOjŒubjdXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file r‘…r’}r“(jKXi values are used for bootstrapping. As part of the TUF infrastructure the repository will contain a file jMNjZNj[hjLjyubj„)r”}r•(jKX ``root.json``jQ}r–(jS]jT]jU]jV]jX]ujLjyjF]r—jdX root.jsonr˜…r™}rš(jKUjLj”ubajOjŒubjdX (for instance, r›…rœ}r(jKX (for instance, jMNjZNj[hjLjyubcdocutils.nodes reference rž)rŸ}r (jKX$http://hackage.haskell.org/root.jsonr¡jQ}r¢(Urefurij¡jV]jU]jS]jT]jX]ujLjyjF]r£jdX$http://hackage.haskell.org/root.jsonr¤…r¥}r¦(jKUjLjŸubajOU referencer§ubjdX>) which the client needs to do verification. However, how can r¨…r©}rª(jKX>) which the client needs to do verification. However, how can jMNjZNj[hjLjyubj„)r«}r¬(jKX ``cabal``jQ}r­(jS]jT]jU]jV]jX]ujLjyjF]r®jdXcabalr¯…r°}r±(jKUjLj«ubajOjŒubjdX verify the r²…r³}r´(jKX verify the jMNjZNj[hjLjyubj„)rµ}r¶(jKX ``root.json``jQ}r·(jS]jT]jU]jV]jX]ujLjyjF]r¸jdX root.jsonr¹…rº}r»(jKUjLjµubajOjŒubjdX file r¼…r½}r¾(jKX file jMNjZNj[hjLjyubcdocutils.nodes emphasis r¿)rÀ}rÁ(jKX*itself*jQ}rÂ(jS]jT]jU]jV]jX]ujLjyjF]rÃjdXitselfrÄ…rÅ}rÆ(jKUjLjÀubajOUemphasisrÇubjdXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, rÈ…rÉ}rÊ(jKXg? This is known as bootstrapping: if you specify a list of root key IDs and a corresponding threshold, jMNjZNj[hjLjyubj„)rË}rÌ(jKX ``cabal``jQ}rÍ(jS]jT]jU]jV]jX]ujLjyjF]rÎjdXcabalrÏ…rÐ}rÑ(jKUjLjËubajOjŒubjdX! will verify that the downloaded rÒ…rÓ}rÔ(jKX! will verify that the downloaded jMNjZNj[hjLjyubj„)rÕ}rÖ(jKX ``root.json``jQ}r×(jS]jT]jU]jV]jX]ujLjyjF]rØjdX root.jsonrÙ…rÚ}rÛ(jKUjLjÕubajOjŒubjdX$ file has been signed with at least rÜ…rÝ}rÞ(jKX$ file has been signed with at least jMNjZNj[hjLjyubj„)rß}rà(jKX````jQ}rá(jS]jT]jU]jV]jX]ujLjyjF]râjdXrã…rä}rå(jKUjLjßubajOjŒubjdX keys from your set of ræ…rç}rè(jKX keys from your set of jMNjZNj[hjLjyubj„)ré}rê(jKX````jQ}rë(jS]jT]jU]jV]jX]ujLjyjF]rìjdXrí…rî}rï(jKUjLjéubajOjŒubjdX.…rð}rñ(jKX.jMNjZNj[hjLjyubeubj{)rò}ró(jKX>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.jLj\jMjNjOj~jQ}rô(jS]jT]jU]jV]jX]ujZKUj[hjF]rõ(jdXIYou can, but are not recommended to, omit these two fields. In that case rö…r÷}rø(jKXIYou can, but are not recommended to, omit these two fields. In that case jMNjZNj[hjLjòubj„)rù}rú(jKX ``cabal``jQ}rû(jS]jT]jU]jV]jX]ujLjòjF]rüjdXcabalrý…rþ}rÿ(jKUjLjùubajOjŒubjdX will download the r…r}r(jKX will download the jMNjZNj[hjLjòubj„)r}r(jKX ``root.json``jQ}r(jS]jT]jU]jV]jX]ujLjòjF]rjdX root.jsonr…r}r (jKUjLjubajOjŒubjdX— 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 (jKX— field and use it without verification. Although this bootstrapping step is then unsafe, all subsequent access is secure (provided that the downloaded jMNjZNj[hjLjòubj„)r }r(jKX ``root.json``jQ}r(jS]jT]jU]jV]jX]ujLjòjF]rjdX root.jsonr…r}r(jKUjLj ubajOjŒubjdX+ was not tempered with). Of course, adding r…r}r(jKX+ was not tempered with). Of course, adding jMNjZNj[hjLjòubj„)r}r(jKX ``root-keys``jQ}r(jS]jT]jU]jV]jX]ujLjòjF]rjdX root-keysr…r}r(jKUjLjubajOjŒubjdX and r…r}r (jKX and jMNjZNj[hjLjòubj„)r!}r"(jKX``key-threshold``jQ}r#(jS]jT]jU]jV]jX]ujLjòjF]r$jdX key-thresholdr%…r&}r'(jKUjLj!ubajOjŒubjdXÉ 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*(jKXÉ 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 jMNjZNj[hjLjòubj„)r+}r,(jKX ``cabal``jQ}r-(jS]jT]jU]jV]jX]ujLjòjF]r.jdXcabalr/…r0}r1(jKUjLj+ubajOjŒubjdX proper.r2…r3}r4(jKX proper.jMNjZNj[hjLjòubeubj{)r5}r6(jKXrMore information about the security infrastructure can be found at https://github.com/well-typed/hackage-security.jLj\jMjNjOj~jQ}r7(jS]jT]jU]jV]jX]ujZK_j[hjF]r8(jdXCMore information about the security infrastructure can be found at r9…r:}r;(jKXCMore information about the security infrastructure can be found at jMNjZNj[hjLj5ubjž)r<}r=(jKX.https://github.com/well-typed/hackage-securityr>jQ}r?(Urefurij>jV]jU]jS]jT]jX]ujLj5jF]r@jdX.https://github.com/well-typed/hackage-securityrA…rB}rC(jKUjLj<ubajOj§ubjdX.…rD}rE(jKX.jMNjZNj[hjLj5ubeubeubjH)rF}rG(jKUjLjjMjNjOjPjQ}rH(jS]jT]jU]jV]rIh×ajX]rJh/aujZKcj[hjF]rK(j])rL}rM(jKXLegacy repositoriesrNjLjFjMjNjOjajQ}rO(jS]jT]jU]jV]jX]ujZKcj[hjF]rPjdXLegacy repositoriesrQ…rR}rS(jKjNjMNjZNj[hjLjLubaubj{)rT}rU(jKXaCurrently ``cabal`` supports two kinds of “legacy†repositories. The first is specified usingjLjFjMjNjOj~jQ}rV(jS]jT]jU]jV]jX]ujZKej[hjF]rW(jdX Currently rX…rY}rZ(jKX Currently jMNjZNj[hjLjTubj„)r[}r\(jKX ``cabal``jQ}r](jS]jT]jU]jV]jX]ujLjTjF]r^jdXcabalr_…r`}ra(jKUjLj[ubajOjŒubjdXN supports two kinds of “legacy†repositories. The first is specified usingrb…rc}rd(jKXN supports two kinds of “legacy†repositories. The first is specified usingjMNjZNj[hjLjTubeubj¸)re}rf(jKXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archivejLjFjMjNjOj»jQ}rg(j¿jÀjV]jU]jS]jT]jX]ujZKjj[hjF]rhjdXLremote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archiveri…rj}rk(jKUjLjeubaubj{)rl}rm(jKX This is just syntactic sugar forrnjLjFjMjNjOj~jQ}ro(jS]jT]jU]jV]jX]ujZKlj[hjF]rpjdX This is just syntactic sugar forrq…rr}rs(jKjnjMNjZNj[hjLjlubaubj¸)rt}ru(jKXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archivejLjFjMjNjOj»jQ}rv(j¿jÀjV]jU]jS]jT]jX]ujZKpj[hjF]rwjdXerepository hackage.haskell.org url: hackage.haskell.org:http://hackage.haskell.org/packages/archiverx…ry}rz(jKUjLjtubaubj{)r{}r|(jKX°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/``.jLjFjMjNjOj~jQ}r}(jS]jT]jU]jV]jX]ujZKsj[hjF]r~(jdXAalthough, in (and only in) the specific case of Hackage, the URL r…r€}r(jKXAalthough, in (and only in) the specific case of Hackage, the URL jMNjZNj[hjLj{ubj„)r‚}rƒ(jKX/``http://hackage.haskell.org/packages/archive``jQ}r„(jS]jT]jU]jV]jX]ujLj{jF]r…jdX+http://hackage.haskell.org/packages/archiver†…r‡}rˆ(jKUjLj‚ubajOjŒubjdX will be silently translated to r‰…rŠ}r‹(jKX will be silently translated to jMNjZNj[hjLj{ubj„)rŒ}r(jKX``http://hackage.haskell.org/``jQ}rŽ(jS]jT]jU]jV]jX]ujLj{jF]rjdXhttp://hackage.haskell.org/r…r‘}r’(jKUjLjŒubajOjŒubjdX.…r“}r”(jKX.jMNjZNj[hjLj{ubeubj{)r•}r–(jKXNThe second kind of legacy repositories are so-called “local†repositories:r—jLjFjMjNjOj~jQ}r˜(jS]jT]jU]jV]jX]ujZKwj[hjF]r™jdXNThe second kind of legacy repositories are so-called “local†repositories:rš…r›}rœ(jKj—jMNjZNj[hjLj•ubaubj¸)r}rž(jKX-local-repo: my-local-repo:/path/to/local/repojLjFjMjNjOj»jQ}rŸ(j¿jÀjV]jU]jS]jT]jX]ujZK|j[hjF]r jdX-local-repo: my-local-repo:/path/to/local/repor¡…r¢}r£(jKUjLjubaubj{)r¤}r¥(jKXÛ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¦jLjFjMjNjOj~jQ}r§(jS]jT]jU]jV]jX]ujZK~j[hjF]r¨jdXÛ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«(jKj¦jMNjZNj[hjLj¤ubaubeubjH)r¬}r­(jKUjLjjMjNjOjPjQ}r®(jS]jT]jU]jV]r¯h¼ajX]r°haujZK„j[hjF]r±(j])r²}r³(jKXSecure local repositoriesr´jLj¬jMjNjOjajQ}rµ(jS]jT]jU]jV]jX]ujZK„j[hjF]r¶jdXSecure local repositoriesr·…r¸}r¹(jKj´jMNjZNj[hjLj²ubaubj{)rº}r»(jKXxIf you want to use repositories on your local file system, it is recommended instead to use a *secure* local repository:jLj¬jMjNjOj~jQ}r¼(jS]jT]jU]jV]jX]ujZK†j[hjF]r½(jdX^If you want to use repositories on your local file system, it is recommended instead to use a r¾…r¿}rÀ(jKX^If you want to use repositories on your local file system, it is recommended instead to use a jMNjZNj[hjLjºubj¿)rÁ}rÂ(jKX*secure*jQ}rÃ(jS]jT]jU]jV]jX]ujLjºjF]rÄjdXsecurerÅ…rÆ}rÇ(jKUjLjÁubajOjÇubjdX local repository:rÈ…rÉ}rÊ(jKX local repository:jMNjZNj[hjLjºubeubj¸)rË}rÌ(jKX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: jLj¬jMjNjOj»jQ}rÍ(j¿jÀjV]jU]jS]jT]jX]ujZK‹j[hjF]rÎjdX„repository my-local-repo url: file:/path/to/local/repo secure: True root-keys: key-threshold: rÏ…rÐ}rÑ(jKUjLjËubaubj{)rÒ}rÓ(jKX²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.jLj¬jMjNjOj~jQ}rÔ(jS]jT]jU]jV]jX]ujZK‘j[hjF]rÕ(jdX^The layout of these secure local repos matches the layout of remote repositories exactly; the rÖ…r×}rØ(jKX^The layout of these secure local repos matches the layout of remote repositories exactly; the jMNjZNj[hjLjÒubjž)rÙ}rÚ(jKXhackage-repo-tooljQ}rÛ(UrefuriX4http://hackage.haskell.org/package/hackage-repo-tooljV]jU]jS]jT]jX]Uinternal‰ujLjÒjF]rÜjdXhackage-repo-toolrÝ…rÞ}rß(jKUjLjÙubajOj§ubjdX4 can be used to create and manage such repositories.rà…rá}râ(jKX4 can be used to create and manage such repositories.jMNjZNj[hjLjÒubeubcdocutils.nodes target rã)rä}rå(jKX.. _installing-packages:jLj¬jMjNjOUtargetræjQ}rç(jV]jU]jS]jT]jX]Urefidrèj7ujZK•j[hjF]ubeubeubeubjH)ré}rê(jKUjLhjMjNUexpect_referenced_by_namerë}rìh–jäsjOjPjQ}rí(jS]jT]jU]jV]rî(h¾j7ejX]rï(hh–eujZK˜j[hUexpect_referenced_by_idrð}rñj7jäsjF]rò(j])ró}rô(jKX Building and installing packagesrõjLjéjMjNjOjajQ}rö(jS]jT]jU]jV]jX]ujZK˜j[hjF]r÷jdX Building and installing packagesrø…rù}rú(jKjõjMNjZNj[hjLjóubaubjh)rû}rü(jKUjLjéjMjNjOjkjQ}rý(UlangXconsoleUlinenothresholdI9223372036854775807 jV]jU]jS]jT]jX]ujZK›j[hjF]ubj{)rþ}rÿ(jKXŽ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:jLjéjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZKœj[hjF]r(jdX{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(jKXyAfter you've unpacked a Cabal package, you can build it by moving into the root directory of the package and running the jMNjZNj[hjLjþubj„)r}r(jKX ``cabal``jQ}r(jS]jT]jU]jV]jX]ujLjþjF]rjdXcabalr …r }r (jKUjLjubajOjŒubjdX tool there:r …r }r(jKX tool there:jMNjZNj[hjLjþubeubj¸)r}r(jKX$ cabal [command] [option...]jLjéjMjNjOj»jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZK¡j[hjF]rjdX$ cabal [command] [option...]r…r}r(jKUjLjubaubj{)r}r(jKXNThe *command* argument selects a particular step in the build/install process.jLjéjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZK£j[hjF]r(jdXThe r…r}r(jKXThe jMNjZNj[hjLjubj¿)r}r(jKX *command*jQ}r(jS]jT]jU]jV]jX]ujLjjF]r jdXcommandr!…r"}r#(jKUjLjubajOjÇubjdXA argument selects a particular step in the build/install process.r$…r%}r&(jKXA argument selects a particular step in the build/install process.jMNjZNj[hjLjubeubj{)r'}r((jKX5You can also get a summary of the command syntax withr)jLjéjMjNjOj~jQ}r*(jS]jT]jU]jV]jX]ujZK¦j[hjF]r+jdX5You can also get a summary of the command syntax withr,…r-}r.(jKj)jMNjZNj[hjLj'ubaubj¸)r/}r0(jKX $ cabal helpjLjéjMjNjOj»jQ}r1(j¿jÀjV]jU]jS]jT]jX]ujZKªj[hjF]r2jdX $ cabal helpr3…r4}r5(jKUjLj/ubaubj{)r6}r7(jKXIAlternatively, you can also use the ``Setup.hs`` or ``Setup.lhs`` script:jLjéjMjNjOj~jQ}r8(jS]jT]jU]jV]jX]ujZK¬j[hjF]r9(jdX$Alternatively, you can also use the r:…r;}r<(jKX$Alternatively, you can also use the jMNjZNj[hjLj6ubj„)r=}r>(jKX ``Setup.hs``jQ}r?(jS]jT]jU]jV]jX]ujLj6jF]r@jdXSetup.hsrA…rB}rC(jKUjLj=ubajOjŒubjdX or rD…rE}rF(jKX or jMNjZNj[hjLj6ubj„)rG}rH(jKX ``Setup.lhs``jQ}rI(jS]jT]jU]jV]jX]ujLj6jF]rJjdX Setup.lhsrK…rL}rM(jKUjLjGubajOjŒubjdX script:rN…rO}rP(jKX script:jMNjZNj[hjLj6ubeubj¸)rQ}rR(jKX+$ runhaskell Setup.hs [command] [option...]jLjéjMjNjOj»jQ}rS(j¿jÀjV]jU]jS]jT]jX]ujZK±j[hjF]rTjdX+$ runhaskell Setup.hs [command] [option...]rU…rV}rW(jKUjLjQubaubj{)rX}rY(jKX+For the summary of the command syntax, run:rZjLjéjMjNjOj~jQ}r[(jS]jT]jU]jV]jX]ujZK³j[hjF]r\jdX+For the summary of the command syntax, run:r]…r^}r_(jKjZjMNjZNj[hjLjXubaubj¸)r`}ra(jKX $ cabal helpjLjéjMjNjOj»jQ}rb(j¿jÀjV]jU]jS]jT]jX]ujZK·j[hjF]rcjdX $ cabal helprd…re}rf(jKUjLj`ubaubj{)rg}rh(jKXorrijLjéjMjNjOj~jQ}rj(jS]jT]jU]jV]jX]ujZK¹j[hjF]rkjdXorrl…rm}rn(jKjijMNjZNj[hjLjgubaubj¸)ro}rp(jKX$ runhaskell Setup.hs --helpjLjéjMjNjOj»jQ}rq(j¿jÀjV]jU]jS]jT]jX]ujZK½j[hjF]rrjdX$ runhaskell Setup.hs --helprs…rt}ru(jKUjLjoubaubjH)rv}rw(jKUjLjéjMjNjOjPjQ}rx(jS]jT]jU]jV]ryjajX]rzhqaujZKÀj[hjF]r{(j])r|}r}(jKX(Building and installing a system packager~jLjvjMjNjOjajQ}r(jS]jT]jU]jV]jX]ujZKÀj[hjF]r€jdX(Building and installing a system packager…r‚}rƒ(jKj~jMNjZNj[hjLj|ubaubj¸)r„}r…(jKX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installjLjvjMjNjOj»jQ}r†(j¿jÀjV]jU]jS]jT]jX]ujZKÄj[hjF]r‡jdX_$ runhaskell Setup.hs configure --ghc $ runhaskell Setup.hs build $ runhaskell Setup.hs installrˆ…r‰}rŠ(jKUjLj„ubaubj{)r‹}rŒ(jKX 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.rjLjvjMjNjOj~jQ}rŽ(jS]jT]jU]jV]jX]ujZKÈj[hjF]rjdX 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’(jKjjMNjZNj[hjLj‹ubaubeubjH)r“}r”(jKUjLjéjMjNjOjPjQ}r•(jS]jT]jU]jV]r–hÎajX]r—h&aujZKÎj[hjF]r˜(j])r™}rš(jKX&Building and installing a user packager›jLj“jMjNjOjajQ}rœ(jS]jT]jU]jV]jX]ujZKÎj[hjF]rjdX&Building and installing a user packagerž…rŸ}r (jKj›jMNjZNj[hjLj™ubaubj¸)r¡}r¢(jKX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installjLj“jMjNjOj»jQ}r£(j¿jÀjV]jU]jS]jT]jX]ujZKÒj[hjF]r¤jdX`$ runhaskell Setup.hs configure --user $ runhaskell Setup.hs build $ runhaskell Setup.hs installr¥…r¦}r§(jKUjLj¡ubaubj{)r¨}r©(jKXThe package is installed under the user's home directory and is registered in the user's package database (:option:`setup configure --user`).jLj“jMjNjOj~jQ}rª(jS]jT]jU]jV]jX]ujZKÖj[hjF]r«(jdXoThe package is installed under the user’s home directory and is registered in the user’s package database (r¬…r­}r®(jKXkThe package is installed under the user's home directory and is registered in the user's package database (jMNjZNj[hjLj¨ubcsphinx.addnodes pending_xref r¯)r°}r±(jKX :option:`setup configure --user`r²jLj¨jMjNjOU pending_xrefr³jQ}r´(UreftypeXoptionUrefwarnrµˆU reftargetr¶Xsetup configure --userU refdomainXstdr·jV]jU]U refexplicit‰jS]jT]jX]Urefdocr¸Xinstalling-packagesr¹U std:programrºNujZKÖjF]r»j„)r¼}r½(jKj²jQ}r¾(jS]jT]r¿(UxrefrÀj·X std-optionrÁejU]jV]jX]ujLj°jF]rÂjdXsetup configure --userrÃ…rÄ}rÅ(jKUjLj¼ubajOjŒubaubjdX).rÆ…rÇ}rÈ(jKX).jMNjZNj[hjLj¨ubeubeubjH)rÉ}rÊ(jKUjLjéjMjNjOjPjQ}rË(jS]jT]jU]jV]rÌj%ajX]rÍhaujZKÚj[hjF]rÎ(j])rÏ}rÐ(jKX Installing packages from HackagerÑjLjÉjMjNjOjajQ}rÒ(jS]jT]jU]jV]jX]ujZKÚj[hjF]rÓjdX Installing packages from HackagerÔ…rÕ}rÖ(jKjÑjMNjZNj[hjLjÏubaubj{)r×}rØ(jKX”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:jLjÉjMjNjOj~jQ}rÙ(jS]jT]jU]jV]jX]ujZKÜj[hjF]rÚ(jdXThe rÛ…rÜ}rÝ(jKXThe jMNjZNj[hjLj×ubj„)rÞ}rß(jKX ``cabal``jQ}rà(jS]jT]jU]jV]jX]ujLj×jF]rájdXcabalrâ…rã}rä(jKUjLjÞubajOjŒubjdX8 tool also can download, configure, build and install a rå…ræ}rç(jKX8 tool also can download, configure, build and install a jMNjZNj[hjLj×ubjž)rè}ré(jKXHackage_UresolvedrêKjLj×jOj§jQ}rë(UnameXHackageUrefurirìXhttp://hackage.haskell.org/ríjV]jU]jS]jT]jX]ujF]rîjdXHackagerï…rð}rñ(jKUjLjèubaubjdXG package and all of its dependencies in a single step. To do this, run:rò…ró}rô(jKXG package and all of its dependencies in a single step. To do this, run:jMNjZNj[hjLj×ubeubj¸)rõ}rö(jKX$ cabal install [PACKAGE...]jLjÉjMjNjOj»jQ}r÷(j¿jÀjV]jU]jS]jT]jX]ujZKâj[hjF]røjdX$ cabal install [PACKAGE...]rù…rú}rû(jKUjLjõubaubj{)rü}rý(jKXFTo browse the list of available packages, visit the Hackage_ web site.jLjÉjMjNjOj~jQ}rþ(jS]jT]jU]jV]jX]ujZKäj[hjF]rÿ(jdX4To browse the list of available packages, visit the r…r}r(jKX4To browse the list of available packages, visit the jMNjZNj[hjLjüubjž)r}r(jKXHackage_jêKjLjüjOj§jQ}r(UnameXHackagejìjíjV]jU]jS]jT]jX]ujF]rjdXHackager…r}r (jKUjLjubaubjdX web site.r …r }r (jKX web site.jMNjZNj[hjLjüubeubeubjH)r }r(jKUjLjéjMjNjOjPjQ}r(jS]jT]jU]jV]rjajX]rhmaujZKèj[hjF]r(j])r}r(jKXDeveloping with sandboxesrjLj jMjNjOjajQ}r(jS]jT]jU]jV]jX]ujZKèj[hjF]rjdXDeveloping with sandboxesr…r}r(jKjjMNjZNj[hjLjubaubj{)r}r(jKXé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.jLj jMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZKêj[hjF]r(jdXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using r…r }r!(jKXpBy default, any dependencies of the package are installed into the global or user package databases (e.g. using jMNjZNj[hjLjubj„)r"}r#(jKX%``cabal install --only-dependencies``jQ}r$(jS]jT]jU]jV]jX]ujLjjF]r%jdX!cabal install --only-dependenciesr&…r'}r((jKUjLj"ubajOjŒubjdXZ). 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+(jKXT). 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.jMNjZNj[hjLjubeubj{)r,}r-(jKXiFor more on sandboxes, see also `this article `__.jLj jMjNjOj~jQ}r.(jS]jT]jU]jV]jX]ujZKój[hjF]r/(jdX For more on sandboxes, see also r0…r1}r2(jKX For more on sandboxes, see also jMNjZNj[hjLj,ubjž)r3}r4(jKXH`this article `__jQ}r5(UnameX this articlejìX5http://coldwa.st/e/blog/2013-08-20-Cabal-sandbox.htmljV]jU]jS]jT]jX]ujLj,jF]r6jdX this articler7…r8}r9(jKUjLj3ubajOj§ubjdX.…r:}r;(jKX.jMNjZNj[hjLj,ubeubjH)r<}r=(jKUjLj jMjNjOjPjQ}r>(jS]jT]jU]jV]r?hÂajX]r@haujZK÷j[hjF]rA(j])rB}rC(jKXSandboxes: basic usagerDjLj<jMjNjOjajQ}rE(jS]jT]jU]jV]jX]ujZK÷j[hjF]rFjdXSandboxes: basic usagerG…rH}rI(jKjDjMNjZNj[hjLjBubaubj{)rJ}rK(jKXµ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.jLj<jMjNjOj~jQ}rL(jS]jT]jU]jV]jX]ujZKùj[hjF]rM(jdX<To initialise a fresh sandbox in the current directory, run rN…rO}rP(jKX<To initialise a fresh sandbox in the current directory, run jMNjZNj[hjLjJubj„)rQ}rR(jKX``cabal sandbox init``jQ}rS(jS]jT]jU]jV]jX]ujLjJjF]rTjdXcabal sandbox initrU…rV}rW(jKUjLjQubajOjŒubjdX#. All subsequent commands (such as rX…rY}rZ(jKX#. All subsequent commands (such as jMNjZNj[hjLjJubj„)r[}r\(jKX ``build``jQ}r](jS]jT]jU]jV]jX]ujLjJjF]r^jdXbuildr_…r`}ra(jKUjLj[ubajOjŒubjdX and rb…rc}rd(jKX and jMNjZNj[hjLjJubj„)re}rf(jKX ``install``jQ}rg(jS]jT]jU]jV]jX]ujLjJjF]rhjdXinstallri…rj}rk(jKUjLjeubajOjŒubjdX') from this point will use the sandbox.rl…rm}rn(jKX') from this point will use the sandbox.jMNjZNj[hjLjJubeubj¸)ro}rp(jKXþ$ 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 sandboxjLj<jMjNjOj»jQ}rq(j¿jÀjV]jU]jS]jT]jX]ujZKÿj[hjF]rrjdXþ$ 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 sandboxrs…rt}ru(jKUjLjoubaubj{)rv}rw(jKX`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.jLj<jMjNjOj~jQ}rx(jS]jT]jU]jV]jX]ujZMj[hjF]ry(jdXÉ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 rz…r{}r|(jKXÉ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 jMNjZNj[hjLjvubj„)r}}r~(jKX``cabal sandbox add-source``jQ}r(jS]jT]jU]jV]jX]ujLjvjF]r€jdXcabal sandbox add-sourcer…r‚}rƒ(jKUjLj}ubajOjŒubjdX# command - think of it as “local r„…r…}r†(jKX! command - think of it as "local jMNjZNj[hjLjvubjž)r‡}rˆ(jKXHackage_jêKjLjvjOj§jQ}r‰(UnameXHackagejìjíjV]jU]jS]jT]jX]ujF]rŠjdXHackager‹…rŒ}r(jKUjLj‡ubaubjdXTâ€. If an add-source dependency is later modified, it is reinstalled automatically.rŽ…r}r(jKXR". If an add-source dependency is later modified, it is reinstalled automatically.jMNjZNj[hjLjvubeubj¸)r‘}r’(jKXš$ 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 reinstalledjLj<jMjNjOj»jQ}r“(j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r”jdXš$ 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—(jKUjLj‘ubaubj{)r˜}r™(jKX­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.jLj<jMjNjOj~jQ}rš(jS]jT]jU]jV]jX]ujZMj[hjF]r›(jdXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (rœ…r}rž(jKXkNormally, the sandbox settings (such as optimisation level) are inherited from the main Cabal config file (jMNjZNj[hjLj˜ubj„)rŸ}r (jKX``$HOME/cabal/config``jQ}r¡(jS]jT]jU]jV]jX]ujLj˜jF]r¢jdX$HOME/cabal/configr£…r¤}r¥(jKUjLjŸubajOjŒubjdXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a r¦…r§}r¨(jKXx). Sometimes, though, you need to change some settings specifically for a single sandbox. You can do this by creating a jMNjZNj[hjLj˜ubj„)r©}rª(jKX``cabal.config``jQ}r«(jS]jT]jU]jV]jX]ujLj˜jF]r¬jdX cabal.configr­…r®}r¯(jKUjLj©ubajOjŒubjdX& file in the same directory with your r°…r±}r²(jKX& file in the same directory with your jMNjZNj[hjLj˜ubj„)r³}r´(jKX``cabal.sandbox.config``jQ}rµ(jS]jT]jU]jV]jX]ujLj˜jF]r¶jdXcabal.sandbox.configr·…r¸}r¹(jKUjLj³ubajOjŒubjdX (which was created by rº…r»}r¼(jKX (which was created by jMNjZNj[hjLj˜ubj„)r½}r¾(jKX``sandbox init``jQ}r¿(jS]jT]jU]jV]jX]ujLj˜jF]rÀjdX sandbox initrÁ…rÂ}rÃ(jKUjLj½ubajOjŒubjdX?). This file has the same syntax as the main Cabal config file.rÄ…rÅ}rÆ(jKX?). This file has the same syntax as the main Cabal config file.jMNjZNj[hjLj˜ubeubj¸)rÇ}rÈ(jKX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filejLj<jMjNjOj»jQ}rÉ(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÊjdX©$ cat cabal.config documentation: True constraints: foo == 1.0, bar >= 2.0, baz $ cabal build # Uses settings from the cabal.config filerË…rÌ}rÍ(jKUjLjÇubaubj{)rÎ}rÏ(jKXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÐjLj<jMjNjOj~jQ}rÑ(jS]jT]jU]jV]jX]ujZM!j[hjF]rÒjdXeWhen you have decided that you no longer want to build your package inside a sandbox, just delete it:rÓ…rÔ}rÕ(jKjÐjMNjZNj[hjLjÎubaubj¸)rÖ}r×(jKXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodjLj<jMjNjOj»jQ}rØ(j¿jÀjV]jU]jS]jT]jX]ujZM&j[hjF]rÙjdXˆ$ cabal sandbox delete # Built-in command $ rm -rf .cabal-sandbox cabal.sandbox.config # Alternative manual methodrÚ…rÛ}rÜ(jKUjLjÖubaubeubjH)rÝ}rÞ(jKUjLj jMjNjOjPjQ}rß(jS]jT]jU]jV]ràh³ajX]ráh aujZM*j[hjF]râ(j])rã}rä(jKXSandboxes: advanced usageråjLjÝjMjNjOjajQ}ræ(jS]jT]jU]jV]jX]ujZM*j[hjF]rçjdXSandboxes: advanced usagerè…ré}rê(jKjåjMNjZNj[hjLjãubaubj{)rë}rì(jKXThe 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.jLjÝjMjNjOj~jQ}rí(jS]jT]jU]jV]jX]ujZM,j[hjF]rî(jdXThe default behaviour of the rï…rð}rñ(jKXThe default behaviour of the jMNjZNj[hjLjëubj„)rò}ró(jKX``add-source``jQ}rô(jS]jT]jU]jV]jX]ujLjëjF]rõjdX add-sourcerö…r÷}rø(jKUjLjòubajOjŒubjdX· 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û(jKX· 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 jMNjZNj[hjLjëubj„)rü}rý(jKX``add-source --snapshot``jQ}rþ(jS]jT]jU]jV]jX]ujLjëjF]rÿjdXadd-source --snapshotr…r}r(jKUjLjüubajOjŒubjdX5, which disables the change tracking. In addition to r…r}r(jKX5, which disables the change tracking. In addition to jMNjZNj[hjLjëubj„)r}r(jKX``add-source``jQ}r(jS]jT]jU]jV]jX]ujLjëjF]r jdX add-sourcer …r }r (jKUjLjubajOjŒubjdX, there are also r …r}r(jKX, there are also jMNjZNj[hjLjëubj„)r}r(jKX``list-sources``jQ}r(jS]jT]jU]jV]jX]ujLjëjF]rjdX list-sourcesr…r}r(jKUjLjubajOjŒubjdX and r…r}r(jKX and jMNjZNj[hjLjëubj„)r}r(jKX``delete-source``jQ}r(jS]jT]jU]jV]jX]ujLjëjF]rjdX delete-sourcer…r}r (jKUjLjubajOjŒubjdX commands.r!…r"}r#(jKX commands.jMNjZNj[hjLjëubeubj{)r$}r%(jKXSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the ``--sandbox`` option:jLjÝjMjNjOj~jQ}r&(jS]jT]jU]jV]jX]ujZM3j[hjF]r'(jdXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the r(…r)}r*(jKXjSometimes one wants to share a single sandbox between multiple packages. This can be easily done with the jMNjZNj[hjLj$ubj„)r+}r,(jKX ``--sandbox``jQ}r-(jS]jT]jU]jV]jX]ujLj$jF]r.jdX --sandboxr/…r0}r1(jKUjLj+ubajOjŒubjdX option:r2…r3}r4(jKX option:jMNjZNj[hjLj$ubeubj¸)r5}r6(jKXþ$ 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-sandboxjLjÝjMjNjOj»jQ}r7(j¿jÀjV]jU]jS]jT]jX]ujZM8j[hjF]r8jdXþ$ 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-sandboxr9…r:}r;(jKUjLj5ubaubj{)r<}r=(jKXõ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``).jLjÝjMjNjOj~jQ}r>(jS]jT]jU]jV]jX]ujZM@j[hjF]r?(jdX Note that r@…rA}rB(jKX Note that jMNjZNj[hjLj<ubj„)rC}rD(jKX"``cabal sandbox init --sandbox .``jQ}rE(jS]jT]jU]jV]jX]ujLj<jF]rFjdXcabal sandbox init --sandbox .rG…rH}rI(jKUjLjCubajOjŒubjdX@ puts all sandbox files into the current directory. By default, rJ…rK}rL(jKX@ puts all sandbox files into the current directory. By default, jMNjZNj[hjLj<ubj„)rM}rN(jKX``cabal sandbox init``jQ}rO(jS]jT]jU]jV]jX]ujLj<jF]rPjdXcabal sandbox initrQ…rR}rS(jKUjLjMubajOjŒubjdX] initialises a new sandbox in a newly-created subdirectory of the current working directory (rT…rU}rV(jKX] initialises a new sandbox in a newly-created subdirectory of the current working directory (jMNjZNj[hjLj<ubj„)rW}rX(jKX``./.cabal-sandbox``jQ}rY(jS]jT]jU]jV]jX]ujLj<jF]rZjdX./.cabal-sandboxr[…r\}r](jKUjLjWubajOjŒubjdX).r^…r_}r`(jKX).jMNjZNj[hjLj<ubeubj{)ra}rb(jKXcUsing multiple different compiler versions simultaneously is also supported, via the ``-w`` option:jLjÝjMjNjOj~jQ}rc(jS]jT]jU]jV]jX]ujZMEj[hjF]rd(jdXUUsing multiple different compiler versions simultaneously is also supported, via the re…rf}rg(jKXUUsing multiple different compiler versions simultaneously is also supported, via the jMNjZNj[hjLjaubj„)rh}ri(jKX``-w``jQ}rj(jS]jT]jU]jV]jX]ujLjajF]rkjdX-wrl…rm}rn(jKUjLjhubajOjŒubjdX option:ro…rp}rq(jKX option:jMNjZNj[hjLjaubeubj¸)rr}rs(jKXs$ 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 buildjLjÝjMjNjOj»jQ}rt(j¿jÀjV]jU]jS]jT]jX]ujZMJj[hjF]rujdXs$ 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 buildrv…rw}rx(jKUjLjrubaubj{)ry}rz(jKXIIt 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:jLjÝjMjNjOj~jQ}r{(jS]jT]jU]jV]jX]ujZMRj[hjF]r|(jdXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. r}…r~}r(jKXVIt can be occasionally useful to run the compiler-specific package manager tool (e.g. jMNjZNj[hjLjyubj„)r€}r(jKX ``ghc-pkg``jQ}r‚(jS]jT]jU]jV]jX]ujLjyjF]rƒjdXghc-pkgr„…r…}r†(jKUjLj€ubajOjŒubjdXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The r‡…rˆ}r‰(jKXg) tool on the sandbox package DB directly (for example, you may need to unregister some packages). The jMNjZNj[hjLjyubj„)rŠ}r‹(jKX``cabal sandbox hc-pkg``jQ}rŒ(jS]jT]jU]jV]jX]ujLjyjF]rjdXcabal sandbox hc-pkgrŽ…r}r(jKUjLjŠubajOjŒubjdXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:r‘…r’}r“(jKXi command is a convenient wrapper that runs the compiler-specific package manager tool with the arguments:jMNjZNj[hjLjyubeubj¸)r”}r•(jKXâ$ 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' [...]jLjÝjMjNjOj»jQ}r–(j¿jÀjV]jU]jS]jT]jX]ujZMZj[hjF]r—jdXâ$ 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š(jKUjLj”ubaubj{)r›}rœ(jKX¢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``.jLjÝjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMaj[hjF]rž(jdXThe rŸ…r }r¡(jKXThe jMNjZNj[hjLj›ubj„)r¢}r£(jKX``--require-sandbox``jQ}r¤(jS]jT]jU]jV]jX]ujLj›jF]r¥jdX--require-sandboxr¦…r§}r¨(jKUjLj¢ubajOjŒubjdX* option makes all sandbox-aware commands (r©…rª}r«(jKX* option makes all sandbox-aware commands (jMNjZNj[hjLj›ubj„)r¬}r­(jKX ``install``jQ}r®(jS]jT]jU]jV]jX]ujLj›jF]r¯jdXinstallr°…r±}r²(jKUjLj¬ubajOjŒubjdX/…r³}r´(jKX/jMNjZNj[hjLj›ubj„)rµ}r¶(jKX ``build``jQ}r·(jS]jT]jU]jV]jX]ujLj›jF]r¸jdXbuildr¹…rº}r»(jKUjLjµubajOjŒubjdXÄ/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¾(jKXÄ/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 (jMNjZNj[hjLj›ubj„)r¿}rÀ(jKX``~/.cabal/config``jQ}rÁ(jS]jT]jU]jV]jX]ujLj›jF]rÂjdX~/.cabal/configrÃ…rÄ}rÅ(jKUjLj¿ubajOjŒubjdX) or the per-project one (rÆ…rÇ}rÈ(jKX) or the per-project one (jMNjZNj[hjLj›ubj„)rÉ}rÊ(jKX``$PROJECT_DIR/cabal.config``jQ}rË(jS]jT]jU]jV]jX]ujLj›jF]rÌjdX$PROJECT_DIR/cabal.configrÍ…rÎ}rÏ(jKUjLjÉubajOjŒubjdX#). The error can be squelched with rÐ…rÑ}rÒ(jKX#). The error can be squelched with jMNjZNj[hjLj›ubj„)rÓ}rÔ(jKX``--no-require-sandbox``jQ}rÕ(jS]jT]jU]jV]jX]ujLj›jF]rÖjdX--no-require-sandboxr×…rØ}rÙ(jKUjLjÓubajOjŒubjdX.…rÚ}rÛ(jKX.jMNjZNj[hjLj›ubeubj{)rÜ}rÝ(jKXThe 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:jLjÝjMjNjOj~jQ}rÞ(jS]jT]jU]jV]jX]ujZMij[hjF]rß(jdX The option rà…rá}râ(jKX The option jMNjZNj[hjLjÜubj„)rã}rä(jKX``--sandbox-config-file``jQ}rå(jS]jT]jU]jV]jX]ujLjÜjF]ræjdX--sandbox-config-filerç…rè}ré(jKUjLjãubajOjŒubjdX' allows to specify the location of the rê…rë}rì(jKX' allows to specify the location of the jMNjZNj[hjLjÜubj„)rí}rî(jKX``cabal.sandbox.config``jQ}rï(jS]jT]jU]jV]jX]ujLjÜjF]rðjdXcabal.sandbox.configrñ…rò}ró(jKUjLjíubajOjŒubjdX file (by default, rô…rõ}rö(jKX file (by default, jMNjZNj[hjLjÜubj„)r÷}rø(jKX ``cabal``jQ}rù(jS]jT]jU]jV]jX]ujLjÜjF]rújdXcabalrû…rü}rý(jKUjLj÷ubajOjŒubjdX” 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(jKX” searches for it in the current directory). This provides the same functionality as shared sandboxes, but sometimes can be more convenient. Example:jMNjZNj[hjLjÜubeubj¸)r}r(jKXT$ 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 sandboxjLjÝjMjNjOj»jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMpj[hjF]rjdXT$ 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(jKUjLjubaubj{)r}r (jKXdThe sandbox config file can be also specified via the ``CABAL_SANDBOX_CONFIG`` environment variable.jLjÝjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZMzj[hjF]r (jdX6The sandbox config file can be also specified via the r …r }r(jKX6The sandbox config file can be also specified via the jMNjZNj[hjLjubj„)r}r(jKX``CABAL_SANDBOX_CONFIG``jQ}r(jS]jT]jU]jV]jX]ujLjjF]rjdXCABAL_SANDBOX_CONFIGr…r}r(jKUjLjubajOjŒubjdX environment variable.r…r}r(jKX environment variable.jMNjZNj[hjLjubeubj{)r}r(jKXWFinally, the flag ``--ignore-sandbox`` lets you temporarily ignore an existing sandbox:jLjÝjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM}j[hjF]r(jdXFinally, the flag r…r}r(jKXFinally, the flag jMNjZNj[hjLjubj„)r }r!(jKX``--ignore-sandbox``jQ}r"(jS]jT]jU]jV]jX]ujLjjF]r#jdX--ignore-sandboxr$…r%}r&(jKUjLj ubajOjŒubjdX1 lets you temporarily ignore an existing sandbox:r'…r(}r)(jKX1 lets you temporarily ignore an existing sandbox:jMNjZNj[hjLjubeubj¸)r*}r+(jKXš$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cabal --ignore-sandbox install text # Installs 'text' in the user package database ('~/.cabal').jLjÝjMjNjOj»jQ}r,(j¿jÀjV]jU]jS]jT]jX]ujZM‚j[hjF]r-jdXš$ mkdir my/sandbox $ cd my/sandbox $ cabal sandbox init $ cabal --ignore-sandbox install text # Installs 'text' in the user package database ('~/.cabal').r.…r/}r0(jKUjLj*ubaubeubeubjH)r1}r2(jKUjLjéjMjNjOjPjQ}r3(jS]jT]jU]jV]r4hÀajX]r5haujZM‰j[hjF]r6(j])r7}r8(jKXCreating a binary packager9jLj1jMjNjOjajQ}r:(jS]jT]jU]jV]jX]ujZM‰j[hjF]r;jdXCreating a binary packager<…r=}r>(jKj9jMNjZNj[hjLj7ubaubj{)r?}r@(jKX 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:rAjLj1jMjNjOj~jQ}rB(jS]jT]jU]jV]jX]ujZM‹j[hjF]rCjdX 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:rD…rE}rF(jKjAjMNjZNj[hjLj?ubaubj¸)rG}rH(jKX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/jLj1jMjNjOj»jQ}rI(j¿jÀjV]jU]jS]jT]jX]ujZM‘j[hjF]rJjdX$ runhaskell Setup.hs configure --prefix=/usr $ runhaskell Setup.hs build $ runhaskell Setup.hs copy --destdir=/tmp/mypkg $ tar -czf mypkg.tar.gz /tmp/mypkg/rK…rL}rM(jKUjLjGubaubj{)rN}rO(jKXAIf the package contains a library, you need two additional steps:rPjLj1jMjNjOj~jQ}rQ(jS]jT]jU]jV]jX]ujZM–j[hjF]rRjdXAIf the package contains a library, you need two additional steps:rS…rT}rU(jKjPjMNjZNj[hjLjNubaubj¸)rV}rW(jKXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptjLj1jMjNjOj»jQ}rX(j¿jÀjV]jU]jS]jT]jX]ujZMšj[hjF]rYjdXY$ runhaskell Setup.hs register --gen-script $ runhaskell Setup.hs unregister --gen-scriptrZ…r[}r\(jKUjLjVubaubj{)r]}r^(jKXfThis 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.jLj1jMjNjOj~jQ}r_(jS]jT]jU]jV]jX]ujZMj[hjF]r`(jdXThis creates shell scripts ra…rb}rc(jKXThis creates shell scripts jMNjZNj[hjLj]ubj„)rd}re(jKX``register.sh``jQ}rf(jS]jT]jU]jV]jX]ujLj]jF]rgjdX register.shrh…ri}rj(jKUjLjdubajOjŒubjdX and rk…rl}rm(jKX and jMNjZNj[hjLj]ubj„)rn}ro(jKX``unregister.sh``jQ}rp(jS]jT]jU]jV]jX]ujLj]jF]rqjdX unregister.shrr…rs}rt(jKUjLjnubajOjŒubjdXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the ru…rv}rw(jKXu, which must also be sent to the target system. After unpacking there, the package must be registered by running the jMNjZNj[hjLj]ubj„)rx}ry(jKX``register.sh``jQ}rz(jS]jT]jU]jV]jX]ujLj]jF]r{jdX register.shr|…r}}r~(jKUjLjxubajOjŒubjdX script. The r…r€}r(jKX script. The jMNjZNj[hjLj]ubj„)r‚}rƒ(jKX``unregister.sh``jQ}r„(jS]jT]jU]jV]jX]ujLj]jF]r…jdX unregister.shr†…r‡}rˆ(jKUjLj‚ubajOjŒubjdX„ 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‹(jKX„ script would be used in the uninstall procedure of the package. Similar steps may be used for creating binary packages for Windows.jMNjZNj[hjLj]ubeubj{)rŒ}r(jKX5The following options are understood by all commands:rŽjLj1jMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM¤j[hjF]rjdX5The following options are understood by all commands:r‘…r’}r“(jKjŽjMNjZNj[hjLjŒubaubcsphinx.addnodes index r”)r•}r–(jKUjLj1jMjNjOUindexr—jQ}r˜(jV]jU]jS]jT]jX]Uentries]r™(UpairršX+setup command line option; --help, -h or -?hæUNtr›aujZNj[hjF]ubcsphinx.addnodes desc rœ)r}rž(jKUjLj1jMjNjOUdescrŸjQ}r (Unoindexr¡‰Udomainr¢XstdjV]jU]jS]jT]jX]Uobjtyper£Xoptionr¤Udesctyper¥j¤ujZNj[hjF]r¦(csphinx.addnodes desc_signature r§)r¨}r©(jKX--help, -h or -?jLjjMjNjOUdesc_signaturerªjQ}r«(Uallnamesr¬]r­(X--helpr®X-hr¯ejV]r°hæajU]jS]jT]jX]r±(hh>eUfirstr²‰ujZM«j[hjF]r³(csphinx.addnodes desc_name r´)rµ}r¶(jKj®jLj¨jMjNjOU desc_namer·jQ}r¸(j¿jÀjV]jU]jS]jT]jX]ujZM«j[hjF]r¹jdX--helprº…r»}r¼(jKUjMNjZNj[hjLjµubaubcsphinx.addnodes desc_addname r½)r¾}r¿(jKUjLj¨jMjNjOU desc_addnamerÀjQ}rÁ(j¿jÀjV]jU]jS]jT]jX]ujZM«j[hjF]ubj½)rÂ}rÃ(jKU, rÄjLj¨jMjNjOjÀjQ}rÅ(j¿jÀjV]jU]jS]jT]jX]ujZM«j[hjF]rÆjdX, rÇ…rÈ}rÉ(jKUjMNjZNj[hjLjÂubaubj´)rÊ}rË(jKj¯jLj¨jMjNjOj·jQ}rÌ(j¿jÀjV]jU]jS]jT]jX]ujZM«j[hjF]rÍjdX-hrÎ…rÏ}rÐ(jKUjMNjZNj[hjLjÊubaubj½)rÑ}rÒ(jKX or -?jLj¨jMjNjOjÀjQ}rÓ(j¿jÀjV]jU]jS]jT]jX]ujZM«j[hjF]rÔjdX or -?rÕ…rÖ}r×(jKUjMNjZNj[hjLjÑubaubeubcsphinx.addnodes desc_content rØ)rÙ}rÚ(jKUjLjjMjNjOU desc_contentrÛjQ}rÜ(jS]jT]jU]jV]jX]ujZM«j[hjF]rÝj{)rÞ}rß(jKX+List the available options for the command.ràjLjÙjMjNjOj~jQ}rá(jS]jT]jU]jV]jX]ujZMªj[hjF]râjdX+List the available options for the command.rã…rä}rå(jKjàjMNjZNj[hjLjÞubaubaubeubj”)ræ}rç(jKUjLj1jMjNjOj—jQ}rè(jV]jU]jS]jT]jX]Uentries]ré(jšX.setup command line option; --verbose=n or -v njCUNtrêaujZNj[hjF]ubjœ)rë}rì(jKUjLj1jMjNjOjŸjQ}rí(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrîj¥jîujZNj[hjF]rï(j§)rð}rñ(jKX--verbose=n or -v njLjëjMjNjOjªjQ}rò(j¬]róX --verboserôajV]rõjCajU]jS]jT]jX]röh¢aj²‰ujZM¹j[hjF]r÷(j´)rø}rù(jKjôjLjðjMjNjOj·jQ}rú(j¿jÀjV]jU]jS]jT]jX]ujZM¹j[hjF]rûjdX --verboserü…rý}rþ(jKUjMNjZNj[hjLjøubaubj½)rÿ}r(jKX =n or -v njLjðjMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZM¹j[hjF]rjdX =n or -v nr…r}r(jKUjMNjZNj[hjLjÿubaubeubjØ)r}r(jKUjLjëjMjNjOjÛjQ}r(jS]jT]jU]jV]jX]ujZM¹j[hjF]r (j{)r }r (jKXRSet the verbosity level (0-3). The normal level is 1; a missing *n* defaults to 2.jLjjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZM®j[hjF]r (jdX@Set the verbosity level (0-3). The normal level is 1; a missing r…r}r(jKX@Set the verbosity level (0-3). The normal level is 1; a missing jMNjZNj[hjLj ubj¿)r}r(jKX*n*jQ}r(jS]jT]jU]jV]jX]ujLj jF]rjdXn…r}r(jKUjLjubajOjÇubjdX defaults to 2.r…r}r(jKX defaults to 2.jMNjZNj[hjLj ubeubj{)r}r(jKXÅ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.)jLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM±j[hjF]r(jdX}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 (jKX}There is also an extended version of this command which can be used to fine-tune the verbosity of output. It takes the form jMNjZNj[hjLjubj„)r!}r"(jKX!``[silent|normal|verbose|debug]``jQ}r#(jS]jT]jU]jV]jX]ujLjjF]r$jdX[silent|normal|verbose|debug]r%…r&}r'(jKUjLj!ubajOjŒubjdX…r(}r)(jKX\ jMNjZNj[hjLjubj¿)r*}r+(jKX*flags*jQ}r,(jS]jT]jU]jV]jX]ujLjjF]r-jdXflagsr.…r/}r0(jKUjLj*ubajOjÇubjdX, where r1…r2}r3(jKX, where jMNjZNj[hjLjubj¿)r4}r5(jKX*flags*jQ}r6(jS]jT]jU]jV]jX]ujLjjF]r7jdXflagsr8…r9}r:(jKUjLj4ubajOjÇubjdX is a list of r;…r<}r=(jKX is a list of jMNjZNj[hjLjubj„)r>}r?(jKX``+``jQ}r@(jS]jT]jU]jV]jX]ujLjjF]rAjdX+…rB}rC(jKUjLj>ubajOjŒubjdXD flags which toggle various aspects of output. At the moment, only rD…rE}rF(jKXD flags which toggle various aspects of output. At the moment, only jMNjZNj[hjLjubj„)rG}rH(jKX ``+callsite``jQ}rI(jS]jT]jU]jV]jX]ujLjjF]rJjdX +callsiterK…rL}rM(jKUjLjGubajOjŒubjdX and rN…rO}rP(jKX and jMNjZNj[hjLjubj„)rQ}rR(jKX``+callstack``jQ}rS(jS]jT]jU]jV]jX]ujLjjF]rTjdX +callstackrU…rV}rW(jKUjLjQubajOjŒubjdX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)rX…rY}rZ(jKX˜ are supported, which respectively toggle call site and call stack printing (these are only supported if Cabal is built with a sufficiently recent GHC.)jMNjZNj[hjLjubeubeubeubj{)r[}r\(jKX£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]jLj1jMjNjOj~jQ}r^(jS]jT]jU]jV]jX]ujZMºj[hjF]r_jdX£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`…ra}rb(jKj]jMNjZNj[hjLj[ubaubjã)rc}rd(jKX.. _setup-configure:jLj1jMjNjOjæjQ}re(jV]jU]jS]jT]jX]jèjujZM¾j[hjF]ubeubjH)rf}rg(jKUU referencedrhKjLjéjMjNjë}rihwjcsjOjPjQ}rj(jS]jT]jU]jV]rk(jj'ejX]rl(h…hweujZMÁj[hjð}rmjjcsjF]rn(j])ro}rp(jKXsetup configurerqjLjfjMjNjOjajQ}rr(jS]jT]jU]jV]jX]ujZMÁj[hjF]rsjdXsetup configurert…ru}rv(jKjqjMNjZNj[hjLjoubaubj{)rw}rx(jKXÁ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.ryjLjfjMjNjOj~jQ}rz(jS]jT]jU]jV]jX]ujZMÅj[hjF]r{jdXÁ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.r|…r}}r~(jKjyjMNjZNj[hjLjwubaubj{)r}r€(jKXì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.rjLjfjMjNjOj~jQ}r‚(jS]jT]jU]jV]jX]ujZMÉj[hjF]rƒjdXì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†(jKjjMNjZNj[hjLjubaubj{)r‡}rˆ(jKXkIf 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.jLjfjMjNjOj~jQ}r‰(jS]jT]jU]jV]jX]ujZMÎj[hjF]rŠ(jdXIf a user-supplied r‹…rŒ}r(jKXIf a user-supplied jMNjZNj[hjLj‡ubj„)rŽ}r(jKX ``configure``jQ}r(jS]jT]jU]jV]jX]ujLj‡jF]r‘jdX configurer’…r“}r”(jKUjLjŽubajOjŒubjdX# script is run (see the section on r•…r–}r—(jKX# script is run (see the section on jMNjZNj[hjLj‡ubjž)r˜}r™(jKXV`system-dependent parameters `__jQ}rš(UnameXsystem-dependent parametersjìX4developing-packages.html#system-dependent-parametersjV]jU]jS]jT]jX]ujLj‡jF]r›jdXsystem-dependent parametersrœ…r}rž(jKUjLj˜ubajOj§ubjdX or on rŸ…r }r¡(jKX or on jMNjZNj[hjLj‡ubjž)r¢}r£(jKXE`complex packages `__jQ}r¤(UnameXcomplex packagesjìX.developing-packages.html#more-complex-packagesjV]jU]jS]jT]jX]ujLj‡jF]r¥jdXcomplex packagesr¦…r§}r¨(jKUjLj¢ubajOj§ubjdX), it is passed the r©…rª}r«(jKX), it is passed the jMNjZNj[hjLj‡ubj¯)r¬}r­(jKX:option:`--with-hc-pkg`r®jLj‡jMjNjOj³jQ}r¯(UreftypeXoptionjµˆj¶X --with-hc-pkgU refdomainXstdr°jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºXsetup-configurer±ujZMÎjF]r²j„)r³}r´(jKj®jQ}rµ(jS]jT]r¶(jÀj°X std-optionr·ejU]jV]jX]ujLj¬jF]r¸jdX --with-hc-pkgr¹…rº}r»(jKUjLj³ubajOjŒubaubjdX, r¼…r½}r¾(jKX, r¿jMNjZNj[hjLj‡ubj¯)rÀ}rÁ(jKX:option:`--prefix`rÂjLj‡jMjNjOj³jQ}rÃ(UreftypeXoptionjµˆj¶X--prefixU refdomainXstdrÄjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]rÅj„)rÆ}rÇ(jKjÂjQ}rÈ(jS]jT]rÉ(jÀjÄX std-optionrÊejU]jV]jX]ujLjÀjF]rËjdX--prefixrÌ…rÍ}rÎ(jKUjLjÆubajOjŒubaubjdX, rÏ…rÐ}rÑ(jKX, jLj‡ubj¯)rÒ}rÓ(jKX:option:`--bindir`rÔjLj‡jMjNjOj³jQ}rÕ(UreftypeXoptionjµˆj¶X--bindirU refdomainXstdrÖjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]r×j„)rØ}rÙ(jKjÔjQ}rÚ(jS]jT]rÛ(jÀjÖX std-optionrÜejU]jV]jX]ujLjÒjF]rÝjdX--bindirrÞ…rß}rà(jKUjLjØubajOjŒubaubjdX, rá…râ}rã(jKX, jMNjZNj[hjLj‡ubj¯)rä}rå(jKX:option:`--libdir`ræjLj‡jMjNjOj³jQ}rç(UreftypeXoptionjµˆj¶X--libdirU refdomainXstdrèjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]réj„)rê}rë(jKjæjQ}rì(jS]jT]rí(jÀjèX std-optionrîejU]jV]jX]ujLjäjF]rïjdX--libdirrð…rñ}rò(jKUjLjêubajOjŒubaubjdX, ró…rô}rõ(jKX, jLj‡ubj¯)rö}r÷(jKX:option:`--dynlibdir`røjLj‡jMjNjOj³jQ}rù(UreftypeXoptionjµˆj¶X --dynlibdirU refdomainXstdrújV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]rûj„)rü}rý(jKjøjQ}rþ(jS]jT]rÿ(jÀjúX std-optionr ejU]jV]jX]ujLjöjF]r jdX --dynlibdirr …r }r (jKUjLjüubajOjŒubaubjdX, r …r }r (jKX, jLj‡ubj¯)r }r (jKX:option:`--datadir`r jLj‡jMjNjOj³jQ}r (UreftypeXoptionjµˆj¶X --datadirU refdomainXstdr jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]r j„)r }r (jKj jQ}r (jS]jT]r (jÀj X std-optionr ejU]jV]jX]ujLj jF]r jdX --datadirr …r }r (jKUjLj ubajOjŒubaubjdX, r …r }r (jKj¿jLj‡ubj¯)r }r (jKX:option:`--libexecdir`r jLj‡jMjNjOj³jQ}r (UreftypeXoptionjµˆj¶X --libexecdirU refdomainXstdr jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]r j„)r }r! (jKj jQ}r" (jS]jT]r# (jÀj X std-optionr$ ejU]jV]jX]ujLj jF]r% jdX --libexecdirr& …r' }r( (jKUjLj ubajOjŒubaubjdX and r) …r* }r+ (jKX and jMNjZNj[hjLj‡ubj¯)r, }r- (jKX:option:`--sysconfdir`r. jLj‡jMjNjOj³jQ}r/ (UreftypeXoptionjµˆj¶X --sysconfdirU refdomainXstdr0 jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]r1 j„)r2 }r3 (jKj. jQ}r4 (jS]jT]r5 (jÀj0 X std-optionr6 ejU]jV]jX]ujLj, jF]r7 jdX --sysconfdirr8 …r9 }r: (jKUjLj2 ubajOjŒubaubjdX' options. In addition the value of the r; …r< }r= (jKX' options. In addition the value of the jMNjZNj[hjLj‡ubj¯)r> }r? (jKX:option:`--with-compiler`r@ jLj‡jMjNjOj³jQ}rA (UreftypeXoptionjµˆj¶X--with-compilerU refdomainXstdrB jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]rC j„)rD }rE (jKj@ jQ}rF (jS]jT]rG (jÀjB X std-optionrH ejU]jV]jX]ujLj> jF]rI jdX--with-compilerrJ …rK }rL (jKUjLjD ubajOjŒubaubjdX option is passed in a rM …rN }rO (jKX option is passed in a jMNjZNj[hjLj‡ubj¯)rP }rQ (jKX:option:`--with-hc-pkg`rR jLj‡jMjNjOj³jQ}rS (UreftypeXoptionjµˆj¶X --with-hc-pkgU refdomainXstdrT jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]rU j„)rV }rW (jKjR jQ}rX (jS]jT]rY (jÀjT X std-optionrZ ejU]jV]jX]ujLjP jF]r[ jdX --with-hc-pkgr\ …r] }r^ (jKUjLjV ubajOjŒubaubjdX' option and all options specified with r_ …r` }ra (jKX' option and all options specified with jMNjZNj[hjLj‡ubj¯)rb }rc (jKX:option:`--configure-option`rd jLj‡jMjNjOj³jQ}re (UreftypeXoptionjµˆj¶X--configure-optionU refdomainXstdrf jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÎjF]rg j„)rh }ri (jKjd jQ}rj (jS]jT]rk (jÀjf X std-optionrl ejU]jV]jX]ujLjb jF]rm jdX--configure-optionrn …ro }rp (jKUjLjh ubajOjŒubaubjdX are passed on.rq …rr }rs (jKX are passed on.jMNjZNj[hjLj‡ubeubcdocutils.nodes note rt )ru }rv (jKX<`GNU autoconf places restrictions on paths, including the directory that the package is built from. `_ The errors produced when this happens can be obscure; Cabal attempts to detect and warn in this situation, but it is not perfect.jLjfjMjNjOUnoterw jQ}rx (jS]jT]jU]jV]jX]ujZNj[hjF]ry j{)rz }r{ (jKX<`GNU autoconf places restrictions on paths, including the directory that the package is built from. `_ The errors produced when this happens can be obscure; Cabal attempts to detect and warn in this situation, but it is not perfect.jLju jMjNjOj~jQ}r| (jS]jT]jU]jV]jX]ujZMÚjF]r} (jž)r~ }r (jKXº`GNU autoconf places restrictions on paths, including the directory that the package is built from. `_jQ}r€ (UnameXbGNU autoconf places restrictions on paths, including the directory that the package is built from.jìXRhttps://www.gnu.org/software/autoconf/manual/autoconf.html#File-System-Conventionsr jV]jU]jS]jT]jX]ujLjz jF]r‚ jdXbGNU autoconf places restrictions on paths, including the directory that the package is built from.rƒ …r„ }r… (jKUjLj~ ubajOj§ubjã)r† }r‡ (jKXU jhKjLjz jOjæjQ}rˆ (Urefurij jV]r‰ j8ajU]jS]jT]jX]rŠ h—aujF]ubjdX‚ The errors produced when this happens can be obscure; Cabal attempts to detect and warn in this situation, but it is not perfect.r‹ …rŒ }r (jKX‚ The errors produced when this happens can be obscure; Cabal attempts to detect and warn in this situation, but it is not perfect.jLjz ubeubaubj{)rŽ }r (jKX}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:jLjfjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZMàj[hjF]r‘ (jdXDIn Cabal 2.0, support for a single positional argument was added to r’ …r“ }r” (jKXDIn Cabal 2.0, support for a single positional argument was added to jMNjZNj[hjLjŽ ubj„)r• }r– (jKX``setup configure``jQ}r— (jS]jT]jU]jV]jX]ujLjŽ jF]r˜ jdXsetup configurer™ …rš }r› (jKUjLj• ubajOjŒubjdXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with rœ …r }rž (jKXm This makes Cabal configure a the specific component to be configured. Specified names can be qualified with jMNjZNj[hjLjŽ ubj„)rŸ }r  (jKX``lib:``jQ}r¡ (jS]jT]jU]jV]jX]ujLjŽ jF]r¢ jdXlib:r£ …r¤ }r¥ (jKUjLjŸ ubajOjŒubjdX or r¦ …r§ }r¨ (jKX or jMNjZNj[hjLjŽ ubj„)r© }rª (jKX``exe:``jQ}r« (jS]jT]jU]jV]jX]ujLjŽ jF]r¬ jdXexe:r­ …r® }r¯ (jKUjLj© ubajOjŒubjdXL in case just a name is ambiguous (as would be the case for a package named r° …r± }r² (jKXL in case just a name is ambiguous (as would be the case for a package named jMNjZNj[hjLjŽ ubj„)r³ }r´ (jKX``p``jQ}rµ (jS]jT]jU]jV]jX]ujLjŽ jF]r¶ jdXp…r· }r¸ (jKUjLj³ ubajOjŒubjdX- which has a library and an executable named r¹ …rº }r» (jKX- which has a library and an executable named jMNjZNj[hjLjŽ ubj„)r¼ }r½ (jKX``p``jQ}r¾ (jS]jT]jU]jV]jX]ujLjŽ jF]r¿ jdXp…rÀ }rÁ (jKUjLj¼ ubajOjŒubjdX".) This has the following effects:r …rà }rÄ (jKX".) This has the following effects:jMNjZNj[hjLjŽ ubeubcdocutils.nodes bullet_list rÅ )rÆ }rÇ (jKUjLjfjMjNjOU bullet_listrÈ jQ}rÉ (UbulletrÊ X-jV]jU]jS]jT]jX]ujZMçj[hjF]rË (cdocutils.nodes list_item rÌ )rÍ }rÎ (jKXhSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component. jLjÆ jMjNjOU list_itemrÏ jQ}rÐ (jS]jT]jU]jV]jX]ujZNj[hjF]rÑ j{)rÒ }rÓ (jKXgSubsequent invocations of ``cabal build``, ``register``, etc. operate only on the configured component.jLjÍ jMjNjOj~jQ}rÔ (jS]jT]jU]jV]jX]ujZMçjF]rÕ (jdXSubsequent invocations of rÖ …r× }rØ (jKXSubsequent invocations of jLjÒ ubj„)rÙ }rÚ (jKX``cabal build``jQ}rÛ (jS]jT]jU]jV]jX]ujLjÒ jF]rÜ jdX cabal buildrÝ …rÞ }rß (jKUjLjÙ ubajOjŒubjdX, rà …rá }râ (jKX, jLjÒ ubj„)rã }rä (jKX ``register``jQ}rå (jS]jT]jU]jV]jX]ujLjÒ jF]ræ jdXregisterrç …rè }ré (jKUjLjã ubajOjŒubjdX0, etc. operate only on the configured component.rê …rë }rì (jKX0, etc. operate only on the configured component.jLjÒ ubeubaubjÌ )rí }rî (jKXð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``. jLjÆ jMjNjOjÏ jQ}rï (jS]jT]jU]jV]jX]ujZNj[hjF]rð j{)rñ }rò (jKXï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``.jLjí jMjNjOj~jQ}ró (jS]jT]jU]jV]jX]ujZMêjF]rô (jdX¢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÷ (jKXž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 jLjñ ubj¯)rø }rù (jKX:option:`--package-db`rú jLjñ jMjNjOj³jQ}rû (UreftypeXoptionjµˆj¶X --package-dbU refdomainXstdrü jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMêjF]rý j„)rþ }rÿ (jKjú jQ}r (jS]jT]r (jÀjü X std-optionr ejU]jV]jX]ujLjø jF]r jdX --package-dbr …r }r (jKUjLjþ ubajOjŒubaubjdXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using r …r }r (jKXv (and related flags): these dependencies are assumed to be up-to-date. A dependency can be explicitly specified using jLjñ ubj¯)r }r (jKX:option:`--dependency`r jLjñ jMjNjOj³jQ}r (UreftypeXoptionjµˆj¶X --dependencyU refdomainXstdr jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMêjF]r j„)r }r (jKj jQ}r (jS]jT]r (jÀj X std-optionr ejU]jV]jX]ujLj jF]r jdX --dependencyr …r }r (jKUjLj ubajOjŒubaubjdXg simply by giving the name of the internal library; e.g., the dependency for an internal library named r …r }r (jKXg simply by giving the name of the internal library; e.g., the dependency for an internal library named jLjñ ubj„)r }r (jKX``foo``jQ}r (jS]jT]jU]jV]jX]ujLjñ jF]r jdXfoor …r! }r" (jKUjLj ubajOjŒubjdX is given as r# …r$ }r% (jKX is given as jLjñ ubj„)r& }r' (jKX3``--dependency=pkg-internal=pkg-1.0-internal-abcd``jQ}r( (jS]jT]jU]jV]jX]ujLjñ jF]r) jdX/--dependency=pkg-internal=pkg-1.0-internal-abcdr* …r+ }r, (jKUjLj& ubajOjŒubjdX.…r- }r. (jKX.jLjñ ubeubaubjÌ )r/ }r0 (jKXOnly 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.) jLjÆ jMjNjOjÏ jQ}r1 (jS]jT]jU]jV]jX]ujZNj[hjF]r2 j{)r3 }r4 (jKXOnly 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.)jLj/ jMjNjOj~jQ}r5 (jS]jT]jU]jV]jX]ujZMójF]r6 (jdXWOnly the dependencies needed for the requested component are required. Similarly, when r7 …r8 }r9 (jKXWOnly the dependencies needed for the requested component are required. Similarly, when jLj3 ubj¯)r: }r; (jKX:option:`--exact-configuration`r< jLj3 jMjNjOj³jQ}r= (UreftypeXoptionjµˆj¶X--exact-configurationU refdomainXstdr> jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMójF]r? j„)r@ }rA (jKj< jQ}rB (jS]jT]rC (jÀj> X std-optionrD ejU]jV]jX]ujLj: jF]rE jdX--exact-configurationrF …rG }rH (jKUjLj@ ubajOjŒubaubjdX0 is specified, it’s only necessary to specify rI …rJ }rK (jKX. is specified, it's only necessary to specify jLj3 ubj¯)rL }rM (jKX:option:`--dependency`rN jLj3 jMjNjOj³jQ}rO (UreftypeXoptionjµˆj¶X --dependencyU refdomainXstdrP jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMójF]rQ j„)rR }rS (jKjN jQ}rT (jS]jT]rU (jÀjP X std-optionrV ejU]jV]jX]ujLjL jF]rW jdX --dependencyrX …rY }rZ (jKUjLjR ubajOjŒubaubjdX2 for the component. (As mentioned previously, you r[ …r\ }r] (jKX2 for the component. (As mentioned previously, you jLj3 ubj¿)r^ }r_ (jKX*must*jQ}r` (jS]jT]jU]jV]jX]ujLj3 jF]ra jdXmustrb …rc }rd (jKUjLj^ ubajOjÇubjdX( specify internal dependencies as well.)re …rf }rg (jKX( specify internal dependencies as well.)jLj3 ubeubaubjÌ )rh }ri (jKXŽInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``. jLjÆ jMjNjOjÏ jQ}rj (jS]jT]jU]jV]jX]ujZNj[hjF]rk j{)rl }rm (jKXInternal ``build-tool-depends`` and ``build-tools`` dependencies are expected to be in the ``PATH`` upon subsequent invocations of ``setup``.jLjh jMjNjOj~jQ}rn (jS]jT]jU]jV]jX]ujZMùjF]ro (jdX Internal rp …rq }rr (jKX Internal jLjl ubj„)rs }rt (jKX``build-tool-depends``jQ}ru (jS]jT]jU]jV]jX]ujLjl jF]rv jdXbuild-tool-dependsrw …rx }ry (jKUjLjs ubajOjŒubjdX and rz …r{ }r| (jKX and jLjl ubj„)r} }r~ (jKX``build-tools``jQ}r (jS]jT]jU]jV]jX]ujLjl jF]r€ jdX build-toolsr …r‚ }rƒ (jKUjLj} ubajOjŒubjdX( dependencies are expected to be in the r„ …r… }r† (jKX( dependencies are expected to be in the jLjl ubj„)r‡ }rˆ (jKX``PATH``jQ}r‰ (jS]jT]jU]jV]jX]ujLjl jF]rŠ jdXPATHr‹ …rŒ }r (jKUjLj‡ ubajOjŒubjdX upon subsequent invocations of rŽ …r }r (jKX upon subsequent invocations of jLjl ubj„)r‘ }r’ (jKX ``setup``jQ}r“ (jS]jT]jU]jV]jX]ujLjl jF]r” jdXsetupr• …r– }r— (jKUjLj‘ ubajOjŒubjdX.…r˜ }r™ (jKX.jLjl ubeubaubeubj{)rš }r› (jKXŸFull details can be found in the `Componentized Cabal proposal `__.jLjfjMjNjOj~jQ}rœ (jS]jT]jU]jV]jX]ujZMüj[hjF]r (jdX!Full details can be found in the rž …rŸ }r  (jKX!Full details can be found in the jMNjZNj[hjLjš ubjž)r¡ }r¢ (jKX}`Componentized Cabal proposal `__jQ}r£ (UnameXComponentized Cabal proposaljìXZhttps://github.com/ezyang/ghc-proposals/blob/master/proposals/0000-componentized-cabal.rstjV]jU]jS]jT]jX]ujLjš jF]r¤ jdXComponentized Cabal proposalr¥ …r¦ }r§ (jKUjLj¡ ubajOj§ubjdX.…r¨ }r© (jKX.jMNjZNj[hjLjš ubeubjH)rª }r« (jKUjLjfjMjNjOjPjQ}r¬ (jS]jT]jU]jV]r­ hçajX]r® h?aujZMj[hjF]r¯ (j])r° }r± (jKXPrograms used for buildingr² jLjª jMjNjOjajQ}r³ (jS]jT]jU]jV]jX]ujZMj[hjF]r´ jdXPrograms used for buildingrµ …r¶ }r· (jKj² jMNjZNj[hjLj° ubaubj{)r¸ }r¹ (jKXXThe following options govern the programs used to process the source files of a package:rº jLjª jMjNjOj~jQ}r» (jS]jT]jU]jV]jX]ujZMj[hjF]r¼ jdXXThe following options govern the programs used to process the source files of a package:r½ …r¾ }r¿ (jKjº jMNjZNj[hjLj¸ ubaubj”)rÀ }rÁ (jKUjLjª jMjNjOj—jQ}r (jV]jU]jS]jT]jX]Uentries]rà (jšXEsetup-configure command line option; --ghc or -g, --jhc, --lhc, --uhch²UNtrÄ aujZNj[hjF]ubjœ)rÅ }rÆ (jKUjLjª jMjNjOjŸjQ}rÇ (j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÈ j¥jÈ ujZNj[hjF]rÉ (j§)rÊ }rË (jKX --ghc or -g, --jhc, --lhc, --uhcjLjÅ jMjNjOjªjQ}rÌ (j¬]rÍ (X--ghcrÎ X--jhcrÏ X--lhcrÐ X--uhcrÑ ejV]rÒ h²ajU]jS]jT]jX]rÓ (h hƒhyhBej²‰ujZM j[hjF]rÔ (j´)rÕ }rÖ (jKjÎ jLjÊ jMjNjOj·jQ}r× (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]rØ jdX--ghcrÙ …rÚ }rÛ (jKUjMNjZNj[hjLjÕ ubaubj½)rÜ }rÝ (jKX or -gjLjÊ jMjNjOjÀjQ}rÞ (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]rß jdX or -grà …rá }râ (jKUjMNjZNj[hjLjÜ ubaubj½)rã }rä (jKjÄjLjÊ jMjNjOjÀjQ}rå (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]ræ jdX, rç …rè }ré (jKUjMNjZNj[hjLjã ubaubj´)rê }rë (jKjÏ jLjÊ jMjNjOj·jQ}rì (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]rí jdX--jhcrî …rï }rð (jKUjMNjZNj[hjLjê ubaubj½)rñ }rò (jKUjLjÊ jMjNjOjÀjQ}ró (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]ubj½)rô }rõ (jKjÄjLjÊ jMjNjOjÀjQ}rö (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r÷ jdX, rø …rù }rú (jKUjMNjZNj[hjLjô ubaubj´)rû }rü (jKjÐ jLjÊ jMjNjOj·jQ}rý (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]rþ jdX--lhcrÿ …r }r (jKUjMNjZNj[hjLjû ubaubj½)r }r (jKUjLjÊ jMjNjOjÀjQ}r (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]ubj½)r }r (jKjÄjLjÊ jMjNjOjÀjQ}r (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r jdX, r …r }r (jKUjMNjZNj[hjLj ubaubj´)r }r (jKjÑ jLjÊ jMjNjOj·jQ}r (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r jdX--uhcr …r }r (jKUjMNjZNj[hjLj ubaubj½)r }r (jKUjLjÊ jMjNjOjÀjQ}r (j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]ubeubjØ)r }r (jKUjLjÅ jMjNjOjÛjQ}r (jS]jT]jU]jV]jX]ujZM j[hjF]r j{)r }r (jKXÑ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 jLj jMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZMj[hjF]r jdXÑ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! (jKj jMNjZNj[hjLj ubaubaubeubj”)r" }r# (jKUjLjª jMjNjOj—jQ}r$ (jV]jU]jS]jT]jX]Uentries]r% (jšXFsetup-configure command line option; --with-compiler=path or -w *path*hÍUNtr& aujZNj[hjF]ubjœ)r' }r( (jKUjLjª jMjNjOjŸjQ}r) (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr* j¥j* ujZNj[hjF]r+ (j§)r, }r- (jKX!--with-compiler=path or -w *path*jLj' jMjNjOjªjQ}r. (j¬]r/ X--with-compilerr0 ajV]r1 hÍajU]jS]jT]jX]r2 h%aj²‰ujZMj[hjF]r3 (j´)r4 }r5 (jKj0 jLj, jMjNjOj·jQ}r6 (j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r7 jdX--with-compilerr8 …r9 }r: (jKUjMNjZNj[hjLj4 ubaubj½)r; }r< (jKX=path or -w *path*jLj, jMjNjOjÀjQ}r= (j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r> jdX=path or -w *path*r? …r@ }rA (jKUjMNjZNj[hjLj; ubaubeubjØ)rB }rC (jKUjLj' jMjNjOjÛjQ}rD (jS]jT]jU]jV]jX]ujZMj[hjF]rE (j{)rF }rG (jKX³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.rH jLjB jMjNjOj~jQ}rI (jS]jT]jU]jV]jX]ujZMj[hjF]rJ jdX³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.rK …rL }rM (jKjH jMNjZNj[hjLjF ubaubj{)rN }rO (jKXù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).jLjB jMjNjOj~jQ}rP (jS]jT]jU]jV]jX]ujZMj[hjF]rQ (jdX-This flag also sets the default value of the rR …rS }rT (jKX-This flag also sets the default value of the jMNjZNj[hjLjN ubj¯)rU }rV (jKX:option:`--with-hc-pkg`rW jLjN jMjNjOj³jQ}rX (UreftypeXoptionjµˆj¶X --with-hc-pkgU refdomainXstdrY jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]rZ j„)r[ }r\ (jKjW jQ}r] (jS]jT]r^ (jÀjY X std-optionr_ ejU]jV]jX]ujLjU jF]r` jdX --with-hc-pkgra …rb }rc (jKUjLj[ ubajOjŒubaubjdXC option to the package tool for this compiler. Check the output of rd …re }rf (jKXC option to the package tool for this compiler. Check the output of jMNjZNj[hjLjN ubj„)rg }rh (jKX``setup configure -v``jQ}ri (jS]jT]jU]jV]jX]ujLjN jF]rj jdXsetup configure -vrk …rl }rm (jKUjLjg ubajOjŒubjdX8 to ensure that it finds the right package tool (or use rn …ro }rp (jKX8 to ensure that it finds the right package tool (or use jMNjZNj[hjLjN ubj¯)rq }rr (jKX:option:`--with-hc-pkg`rs jLjN jMjNjOj³jQ}rt (UreftypeXoptionjµˆj¶X --with-hc-pkgU refdomainXstdru jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]rv j„)rw }rx (jKjs jQ}ry (jS]jT]rz (jÀju X std-optionr{ ejU]jV]jX]ujLjq jF]r| jdX --with-hc-pkgr} …r~ }r (jKUjLjw ubajOjŒubaubjdX explicitly).r€ …r }r‚ (jKX explicitly).jMNjZNj[hjLjN ubeubeubeubj”)rƒ }r„ (jKUjLjª jMjNjOj—jQ}r… (jV]jU]jS]jT]jX]Uentries]r† (jšX7setup-configure command line option; --with-hc-pkg=pathhÏUNtr‡ aujZNj[hjF]ubjœ)rˆ }r‰ (jKUjLjª jMjNjOjŸjQ}rŠ (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr‹ j¥j‹ ujZNj[hjF]rŒ (j§)r }rŽ (jKX--with-hc-pkg=pathjLjˆ jMjNjOjªjQ}r (j¬]r X --with-hc-pkgr‘ ajV]r’ hÏajU]jS]jT]jX]r“ h'aj²‰ujZMj[hjF]r” (j´)r• }r– (jKj‘ jLj jMjNjOj·jQ}r— (j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r˜ jdX --with-hc-pkgr™ …rš }r› (jKUjMNjZNj[hjLj• ubaubj½)rœ }r (jKX=pathjLj jMjNjOjÀjQ}rž (j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rŸ jdX=pathr  …r¡ }r¢ (jKUjMNjZNj[hjLjœ ubaubeubjØ)r£ }r¤ (jKUjLjˆ jMjNjOjÛjQ}r¥ (jS]jT]jU]jV]jX]ujZMj[hjF]r¦ j{)r§ }r¨ (jKXì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.jLj£ jMjNjOj~jQ}r© (jS]jT]jU]jV]jX]ujZMj[hjF]rª (jdX+Specify the path to the package tool, e.g. r« …r¬ }r­ (jKX+Specify the path to the package tool, e.g. jMNjZNj[hjLj§ ubj„)r® }r¯ (jKX ``ghc-pkg``jQ}r° (jS]jT]jU]jV]jX]ujLj§ jF]r± jdXghc-pkgr² …r³ }r´ (jKUjLj® ubajOjŒubjdXE. The package tool must be compatible with the compiler specified by rµ …r¶ }r· (jKXE. The package tool must be compatible with the compiler specified by jMNjZNj[hjLj§ ubj¯)r¸ }r¹ (jKX:option:`--with-compiler`rº jLj§ jMjNjOj³jQ}r» (UreftypeXoptionjµˆj¶X--with-compilerU refdomainXstdr¼ jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]r½ j„)r¾ }r¿ (jKjº jQ}rÀ (jS]jT]rÁ (jÀj¼ X std-optionr ejU]jV]jX]ujLj¸ jF]rà jdX--with-compilerrÄ …rÅ }rÆ (jKUjLj¾ ubajOjŒubaubjdXX. If this option is omitted, the default value is determined from the compiler selected.rÇ …rÈ }rÉ (jKXX. If this option is omitted, the default value is determined from the compiler selected.jMNjZNj[hjLj§ ubeubaubeubj”)rÊ }rË (jKUjLjª jMjNjOj—jQ}rÌ (jV]jU]jS]jT]jX]Uentries]rÍ (jšX5setup-configure command line option; --with-prog=pathj1UNtrÎ aujZNj[hjF]ubjœ)rÏ }rÐ (jKUjLjª jMjNjOjŸjQ}rÑ (j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÒ j¥jÒ ujZNj[hjF]rÓ (j§)rÔ }rÕ (jKX--with-prog=pathjLjÏ jMjNjOjªjQ}rÖ (j¬]r× X --with-progrØ ajV]rÙ j1ajU]jS]jT]jX]rÚ haj²‰ujZM'j[hjF]rÛ (j´)rÜ }rÝ (jKjØ jLjÔ jMjNjOj·jQ}rÞ (j¿jÀjV]jU]jS]jT]jX]ujZM'j[hjF]rß jdX --with-progrà …rá }râ (jKUjMNjZNj[hjLjÜ ubaubj½)rã }rä (jKX=pathjLjÔ jMjNjOjÀjQ}rå (j¿jÀjV]jU]jS]jT]jX]ujZM'j[hjF]ræ jdX=pathrç …rè }ré (jKUjMNjZNj[hjLjã ubaubeubjØ)rê }rë (jKUjLjÏ jMjNjOjÛjQ}rì (jS]jT]jU]jV]jX]ujZM'j[hjF]rí j{)rî }rï (jKX—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.jLjê jMjNjOj~jQ}rð (jS]jT]jU]jV]jX]ujZM j[hjF]rñ (jdX Specify the path to the program rò …ró }rô (jKX Specify the path to the program jMNjZNj[hjLjî ubj¿)rõ }rö (jKX*prog*jQ}r÷ (jS]jT]jU]jV]jX]ujLjî jF]rø jdXprogrù …rú }rû (jKUjLjõ ubajOjÇubjdX5. Any program known to Cabal can be used in place of rü …rý }rþ (jKX5. Any program known to Cabal can be used in place of jMNjZNj[hjLjî ubj¿)rÿ }r (jKX*prog*jQ}r (jS]jT]jU]jV]jX]ujLjî jF]r jdXprogr …r }r (jKUjLjÿ ubajOjÇubjdXt. 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 (jKXt. It can either be a fully path or the name of a program that can be found on the program search path. For example: jMNjZNj[hjLjî ubj„)r }r (jKX``--with-ghc=ghc-6.6.1``jQ}r (jS]jT]jU]jV]jX]ujLjî jF]r jdX--with-ghc=ghc-6.6.1r …r }r (jKUjLj ubajOjŒubjdX or r …r }r (jKX or jMNjZNj[hjLjî ubj„)r }r (jKX%``--with-cpphs=/usr/local/bin/cpphs``jQ}r (jS]jT]jU]jV]jX]ujLjî jF]r jdX!--with-cpphs=/usr/local/bin/cpphsr …r }r (jKUjLj ubajOjŒubjdXW. The full list of accepted programs is not enumerated in this user guide. Rather, run r …r }r (jKXW. The full list of accepted programs is not enumerated in this user guide. Rather, run jMNjZNj[hjLjî ubj„)r }r (jKX``cabal install --help``jQ}r (jS]jT]jU]jV]jX]ujLjî jF]r jdXcabal install --helpr! …r" }r# (jKUjLj ubajOjŒubjdX to view the list.r$ …r% }r& (jKX to view the list.jMNjZNj[hjLjî ubeubaubeubj”)r' }r( (jKUjLjª jMjNjOj—jQ}r) (jV]jU]jS]jT]jX]Uentries]r* (jšX;setup-configure command line option; --prog-options=optionsjUNtr+ aujZNj[hjF]ubjœ)r, }r- (jKUjLjª jMjNjOjŸjQ}r. (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr/ j¥j/ ujZNj[hjF]r0 (j§)r1 }r2 (jKX--prog-options=optionsjLj, jMjNjOjªjQ}r3 (j¬]r4 X--prog-optionsr5 ajV]r6 jajU]jS]jT]jX]r7 hxaj²‰ujZM2j[hjF]r8 (j´)r9 }r: (jKj5 jLj1 jMjNjOj·jQ}r; (j¿jÀjV]jU]jS]jT]jX]ujZM2j[hjF]r< jdX--prog-optionsr= …r> }r? (jKUjMNjZNj[hjLj9 ubaubj½)r@ }rA (jKX=optionsjLj1 jMjNjOjÀjQ}rB (j¿jÀjV]jU]jS]jT]jX]ujZM2j[hjF]rC jdX=optionsrD …rE }rF (jKUjMNjZNj[hjLj@ ubaubeubjØ)rG }rH (jKUjLj, jMjNjOjÛjQ}rI (jS]jT]jU]jV]jX]ujZM2j[hjF]rJ j{)rK }rL (jKX×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.jLjG jMjNjOj~jQ}rM (jS]jT]jU]jV]jX]ujZM*j[hjF]rN (jdX*Specify additional options to the program rO …rP }rQ (jKX*Specify additional options to the program jMNjZNj[hjLjK ubj¿)rR }rS (jKX*prog*jQ}rT (jS]jT]jU]jV]jX]ujLjK jF]rU jdXprogrV …rW }rX (jKUjLjR ubajOjÇubjdX5. Any program known to Cabal can be used in place of rY …rZ }r[ (jKX5. Any program known to Cabal can be used in place of jMNjZNj[hjLjK ubj¿)r\ }r] (jKX*prog*jQ}r^ (jS]jT]jU]jV]jX]ujLjK jF]r_ jdXprogr` …ra }rb (jKUjLj\ ubajOjÇubjdX. For example: rc …rd }re (jKX. For example: jMNjZNj[hjLjK ubj„)rf }rg (jKX.``--alex-options="--template=mytemplatedir/"``jQ}rh (jS]jT]jU]jV]jX]ujLjK jF]ri jdX*--alex-options="--template=mytemplatedir/"rj …rk }rl (jKUjLjf ubajOjŒubjdX. The rm …rn }ro (jKX. The jMNjZNj[hjLjK ubj¿)rp }rq (jKX *options*jQ}rr (jS]jT]jU]jV]jX]ujLjK jF]rs jdXoptionsrt …ru }rv (jKUjLjp ubajOjÇubjdXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example rw …rx }ry (jKXv is split into program options based on spaces. Any options containing embedded spaced need to be quoted, for example jMNjZNj[hjLjK ubj„)rz }r{ (jKX/``--foo-options='--bar="C:\Program File\Bar"'``jQ}r| (jS]jT]jU]jV]jX]ujLjK jF]r} jdX+--foo-options='--bar="C:\Program File\Bar"'r~ …r }r€ (jKUjLjz ubajOjŒubjdX[. As an alternative that takes only one option at a time but avoids the need to quote, use r …r‚ }rƒ (jKX[. As an alternative that takes only one option at a time but avoids the need to quote, use jMNjZNj[hjLjK ubj¯)r„ }r… (jKX:option:`--prog-option`r† jLjK jMjNjOj³jQ}r‡ (UreftypeXoptionjµˆj¶X --prog-optionU refdomainXstdrˆ jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM*jF]r‰ j„)rŠ }r‹ (jKj† jQ}rŒ (jS]jT]r (jÀjˆ X std-optionrŽ ejU]jV]jX]ujLj„ jF]r jdX --prog-optionr …r‘ }r’ (jKUjLjŠ ubajOjŒubaubjdX instead.r“ …r” }r• (jKX instead.jMNjZNj[hjLjK ubeubaubeubj”)r– }r— (jKUjLjª jMjNjOj—jQ}r˜ (jV]jU]jS]jT]jX]Uentries]r™ (jšX9setup-configure command line option; --prog-option=optionjUNtrš aujZNj[hjF]ubjœ)r› }rœ (jKUjLjª jMjNjOjŸjQ}r (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrž j¥jž ujZNj[hjF]rŸ (j§)r  }r¡ (jKX--prog-option=optionjLj› jMjNjOjªjQ}r¢ (j¬]r£ X --prog-optionr¤ ajV]r¥ jajU]jS]jT]jX]r¦ hkaj²‰ujZM;j[hjF]r§ (j´)r¨ }r© (jKj¤ jLj  jMjNjOj·jQ}rª (j¿jÀjV]jU]jS]jT]jX]ujZM;j[hjF]r« jdX --prog-optionr¬ …r­ }r® (jKUjMNjZNj[hjLj¨ ubaubj½)r¯ }r° (jKX=optionjLj  jMjNjOjÀjQ}r± (j¿jÀjV]jU]jS]jT]jX]ujZM;j[hjF]r² jdX=optionr³ …r´ }rµ (jKUjMNjZNj[hjLj¯ ubaubeubjØ)r¶ }r· (jKUjLj› jMjNjOjÛjQ}r¸ (jS]jT]jU]jV]jX]ujZM;j[hjF]r¹ j{)rº }r» (jKX€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"``.jLj¶ jMjNjOj~jQ}r¼ (jS]jT]jU]jV]jX]ujZM5j[hjF]r½ (jdX2Specify a single additional option to the program r¾ …r¿ }rÀ (jKX2Specify a single additional option to the program jMNjZNj[hjLjº ubj¿)rÁ }r (jKX*prog*jQ}rà (jS]jT]jU]jV]jX]ujLjº jF]rÄ jdXprogrÅ …rÆ }rÇ (jKUjLjÁ ubajOjÇubjdXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than rÈ …rÉ }rÊ (jKXw. For passing an option that contain embedded spaces, such as a file name with embedded spaces, using this rather than jMNjZNj[hjLjº ubj¯)rË }rÌ (jKX:option:`--prog-options`rÍ jLjº jMjNjOj³jQ}rÎ (UreftypeXoptionjµˆj¶X--prog-optionsU refdomainXstdrÏ jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM5jF]rÐ j„)rÑ }rÒ (jKjÍ jQ}rÓ (jS]jT]rÔ (jÀjÏ X std-optionrÕ ejU]jV]jX]ujLjË jF]rÖ jdX--prog-optionsr× …rØ }rÙ (jKUjLjÑ ubajOjŒubaubjdX‹ 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Ü (jKX‹ 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 jMNjZNj[hjLjº ubj„)rÝ }rÞ (jKX-``--foo-options="--bar=C:\Program File\Bar"``jQ}rß (jS]jT]jU]jV]jX]ujLjº jF]rà jdX)--foo-options="--bar=C:\Program File\Bar"rá …râ }rã (jKUjLjÝ ubajOjŒubjdX.…rä }rå (jKX.jMNjZNj[hjLjº ubeubaubeubj{)ræ }rç (jKX¤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.jLjª jMjNjOj~jQ}rè (jS]jT]jU]jV]jX]ujZM<j[hjF]ré (jdX&All of the options passed with either rê …rë }rì (jKX&All of the options passed with either jMNjZNj[hjLjæ ubj¯)rí }rî (jKX:option:`--prog-options`rï jLjæ jMjNjOj³jQ}rð (UreftypeXoptionjµˆj¶X--prog-optionsU refdomainXstdrñ jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM<jF]rò j„)ró }rô (jKjï jQ}rõ (jS]jT]rö (jÀjñ X std-optionr÷ ejU]jV]jX]ujLjí jF]rø jdX--prog-optionsrù …rú }rû (jKUjLjó ubajOjŒubaubjdX or rü …rý }rþ (jKX or jMNjZNj[hjLjæ ubj¯)rÿ }r (jKX:option:`--prog-option`r jLjæ jMjNjOj³jQ}r (UreftypeXoptionjµˆj¶X --prog-optionU refdomainXstdr jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM<jF]r j„)r }r (jKj jQ}r (jS]jT]r (jÀj X std-optionr ejU]jV]jX]ujLjÿ jF]r jdX --prog-optionr …r }r (jKUjLj ubajOjŒubaubjdXK are passed in the order they were specified on the configure command line.r …r }r (jKXK are passed in the order they were specified on the configure command line.jMNjZNj[hjLjæ ubeubeubjH)r }r (jKUjLjfjMjNjOjPjQ}r (jS]jT]jU]jV]r jajX]r h]aujZMAj[hjF]r (j])r }r (jKXInstallation pathsr jLj jMjNjOjajQ}r (jS]jT]jU]jV]jX]ujZMAj[hjF]r jdXInstallation pathsr …r }r (jKj jMNjZNj[hjLj ubaubj{)r }r (jKXLThe following options govern the location of installed files from a package:r! jLj jMjNjOj~jQ}r" (jS]jT]jU]jV]jX]ujZMCj[hjF]r# jdXLThe following options govern the location of installed files from a package:r$ …r% }r& (jKj! jMNjZNj[hjLj ubaubj”)r' }r( (jKUjLj jMjNjOj—jQ}r) (jV]jU]jS]jT]jX]Uentries]r* (jšX1setup-configure command line option; --prefix=dirj6UNtr+ aujZNj[hjF]ubjœ)r, }r- (jKUjLj jMjNjOjŸjQ}r. (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr/ j¥j/ ujZNj[hjF]r0 (j§)r1 }r2 (jKX --prefix=dirjLj, jMjNjOjªjQ}r3 (j¬]r4 X--prefixr5 ajV]r6 j6ajU]jS]jT]jX]r7 h•aj²‰ujZMPj[hjF]r8 (j´)r9 }r: (jKj5 jLj1 jMjNjOj·jQ}r; (j¿jÀjV]jU]jS]jT]jX]ujZMPj[hjF]r< jdX--prefixr= …r> }r? (jKUjMNjZNj[hjLj9 ubaubj½)r@ }rA (jKX=dirjLj1 jMjNjOjÀjQ}rB (j¿jÀjV]jU]jS]jT]jX]ujZMPj[hjF]rC jdX=dirrD …rE }rF (jKUjMNjZNj[hjLj@ ubaubeubjØ)rG }rH (jKUjLj, jMjNjOjÛjQ}rI (jS]jT]jU]jV]jX]ujZMPj[hjF]rJ (j{)rK }rL (jKXú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.jLjG jMjNjOj~jQ}rM (jS]jT]jU]jV]jX]ujZMHj[hjF]rN (jdXMThe root of the installation. For example for a global install you might use rO …rP }rQ (jKXMThe root of the installation. For example for a global install you might use jMNjZNj[hjLjK ubj„)rR }rS (jKX``/usr/local``jQ}rT (jS]jT]jU]jV]jX]ujLjK jF]rU jdX /usr/localrV …rW }rX (jKUjLjR ubajOjŒubjdX on a Unix system, or rY …rZ }r[ (jKX on a Unix system, or jMNjZNj[hjLjK ubj„)r\ }r] (jKX``C:\Program Files``jQ}r^ (jS]jT]jU]jV]jX]ujLjK jF]r_ jdXC:\Program Filesr` …ra }rb (jKUjLj\ ubajOjŒubjdXQ on a Windows system. The other installation paths are usually subdirectories of rc …rd }re (jKXQ on a Windows system. The other installation paths are usually subdirectories of jMNjZNj[hjLjK ubj¿)rf }rg (jKX*prefix*jQ}rh (jS]jT]jU]jV]jX]ujLjK jF]ri jdXprefixrj …rk }rl (jKUjLjf ubajOjÇubjdX, but they don’t have to be.rm …rn }ro (jKX, but they don't have to be.jMNjZNj[hjLjK ubeubj{)rp }rq (jKX¨In the simple build system, *dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjG jMjNjOj~jQ}rr (jS]jT]jU]jV]jX]ujZMMj[hjF]rs (jdXIn the simple build system, rt …ru }rv (jKXIn the simple build system, jMNjZNj[hjLjp ubj¿)rw }rx (jKX*dir*jQ}ry (jS]jT]jU]jV]jX]ujLjp jF]rz jdXdirr{ …r| }r} (jKUjLjw ubajOjÇubjdX+ may contain the following path variables: r~ …r }r€ (jKX+ may contain the following path variables: jMNjZNj[hjLjp ubj„)r }r‚ (jKX ``$pkgid``jQ}rƒ (jS]jT]jU]jV]jX]ujLjp jF]r„ jdX$pkgidr… …r† }r‡ (jKUjLj ubajOjŒubjdX, rˆ …r‰ }rŠ (jKX, r‹ jMNjZNj[hjLjp ubj„)rŒ }r (jKX``$pkg``jQ}rŽ (jS]jT]jU]jV]jX]ujLjp jF]r jdX$pkgr …r‘ }r’ (jKUjLjŒ ubajOjŒubjdX, r“ …r” }r• (jKX, jLjp ubj„)r– }r— (jKX ``$version``jQ}r˜ (jS]jT]jU]jV]jX]ujLjp jF]r™ jdX$versionrš …r› }rœ (jKUjLj– ubajOjŒubjdX, r …rž }rŸ (jKX, jLjp ubj„)r  }r¡ (jKX ``$compiler``jQ}r¢ (jS]jT]jU]jV]jX]ujLjp jF]r£ jdX $compilerr¤ …r¥ }r¦ (jKUjLj  ubajOjŒubjdX, r§ …r¨ }r© (jKX, jMNjZNj[hjLjp ubj„)rª }r« (jKX``$os``jQ}r¬ (jS]jT]jU]jV]jX]ujLjp jF]r­ jdX$osr® …r¯ }r° (jKUjLjª ubajOjŒubjdX, r± …r² }r³ (jKX, jLjp ubj„)r´ }rµ (jKX ``$arch``jQ}r¶ (jS]jT]jU]jV]jX]ujLjp jF]r· jdX$archr¸ …r¹ }rº (jKUjLj´ ubajOjŒubjdX, r» …r¼ }r½ (jKX, jLjp ubj„)r¾ }r¿ (jKX``$abi``jQ}rÀ (jS]jT]jU]jV]jX]ujLjp jF]rÁ jdX$abir …rà }rÄ (jKUjLj¾ ubajOjŒubjdX, rÅ …rÆ }rÇ (jKj‹ jLjp ubj„)rÈ }rÉ (jKX ``$abitag``jQ}rÊ (jS]jT]jU]jV]jX]ujLjp jF]rË jdX$abitagrÌ …rÍ }rÎ (jKUjLjÈ ubajOjŒubeubeubeubj”)rÏ }rÐ (jKUjLj jMjNjOj—jQ}rÑ (jV]jU]jS]jT]jX]Uentries]rÒ (jšX1setup-configure command line option; --bindir=dirhÙUNtrÓ aujZNj[hjF]ubjœ)rÔ }rÕ (jKUjLj jMjNjOjŸjQ}rÖ (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr× j¥j× ujZNj[hjF]rØ (j§)rÙ }rÚ (jKX --bindir=dirjLjÔ jMjNjOjªjQ}rÛ (j¬]rÜ X--bindirrÝ ajV]rÞ hÙajU]jS]jT]jX]rß h1aj²‰ujZMXj[hjF]rà (j´)rá }râ (jKjÝ jLjÙ jMjNjOj·jQ}rã (j¿jÀjV]jU]jS]jT]jX]ujZMXj[hjF]rä jdX--bindirrå …ræ }rç (jKUjMNjZNj[hjLjá ubaubj½)rè }ré (jKX=dirjLjÙ jMjNjOjÀjQ}rê (j¿jÀjV]jU]jS]jT]jX]ujZMXj[hjF]rë jdX=dirrì …rí }rî (jKUjMNjZNj[hjLjè ubaubeubjØ)rï }rð (jKUjLjÔ jMjNjOjÛjQ}rñ (jS]jT]jU]jV]jX]ujZMXj[hjF]rò (j{)ró }rô (jKX:Executables that the user might invoke are installed here.rõ jLjï jMjNjOj~jQ}rö (jS]jT]jU]jV]jX]ujZMSj[hjF]r÷ jdX:Executables that the user might invoke are installed here.rø …rù }rú (jKjõ jMNjZNj[hjLjó ubaubj{)rû }rü (jKXµIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjï jMjNjOj~jQ}rý (jS]jT]jU]jV]jX]ujZMUj[hjF]rþ (jdXIn the simple build system, rÿ …r}r(jKXIn the simple build system, jMNjZNj[hjLjû ubj¿)r}r(jKX*dir*jQ}r(jS]jT]jU]jV]jX]ujLjû jF]rjdXdirr…r}r(jKUjLjubajOjÇubjdX+ may contain the following path variables: r …r }r (jKX+ may contain the following path variables: jMNjZNj[hjLjû ubj„)r }r (jKX ``$prefix``jQ}r(jS]jT]jU]jV]jX]ujLjû jF]rjdX$prefixr…r}r(jKUjLj ubajOjŒubjdX, r…r}r(jKX, rjMNjZNj[hjLjû ubj„)r}r(jKX ``$pkgid``jQ}r(jS]jT]jU]jV]jX]ujLjû jF]rjdX$pkgidr…r}r(jKUjLjubajOjŒubjdX, r…r}r (jKX, jLjû ubj„)r!}r"(jKX``$pkg``jQ}r#(jS]jT]jU]jV]jX]ujLjû jF]r$jdX$pkgr%…r&}r'(jKUjLj!ubajOjŒubjdX, r(…r)}r*(jKX, jLjû ubj„)r+}r,(jKX ``$version``jQ}r-(jS]jT]jU]jV]jX]ujLjû jF]r.jdX$versionr/…r0}r1(jKUjLj+ubajOjŒubjdX, r2…r3}r4(jKX, jMNjZNj[hjLjû ubj„)r5}r6(jKX ``$compiler``jQ}r7(jS]jT]jU]jV]jX]ujLjû jF]r8jdX $compilerr9…r:}r;(jKUjLj5ubajOjŒubjdX, r<…r=}r>(jKX, jLjû ubj„)r?}r@(jKX``$os``jQ}rA(jS]jT]jU]jV]jX]ujLjû jF]rBjdX$osrC…rD}rE(jKUjLj?ubajOjŒubjdX, rF…rG}rH(jKX, jLjû ubj„)rI}rJ(jKX ``$arch``jQ}rK(jS]jT]jU]jV]jX]ujLjû jF]rLjdX$archrM…rN}rO(jKUjLjIubajOjŒubjdX, rP…rQ}rR(jKX, jLjû ubj„)rS}rT(jKX``$abi``jQ}rU(jS]jT]jU]jV]jX]ujLjû jF]rVjdX$abirW…rX}rY(jKUjLjSubajOjŒubjdX, rZ…r[}r\(jKjjLjû ubj„)r]}r^(jKX ``$abitag``jQ}r_(jS]jT]jU]jV]jX]ujLjû jF]r`jdX$abitagra…rb}rc(jKUjLj]ubajOjŒubeubeubeubj”)rd}re(jKUjLj jMjNjOj—jQ}rf(jV]jU]jS]jT]jX]Uentries]rg(jšX1setup-configure command line option; --libdir=dirhÔUNtrhaujZNj[hjF]ubjœ)ri}rj(jKUjLj jMjNjOjŸjQ}rk(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrlj¥jlujZNj[hjF]rm(j§)rn}ro(jKX --libdir=dirjLjijMjNjOjªjQ}rp(j¬]rqX--libdirrrajV]rshÔajU]jS]jT]jX]rth,aj²‰ujZMaj[hjF]ru(j´)rv}rw(jKjrjLjnjMjNjOj·jQ}rx(j¿jÀjV]jU]jS]jT]jX]ujZMaj[hjF]ryjdX--libdirrz…r{}r|(jKUjMNjZNj[hjLjvubaubj½)r}}r~(jKX=dirjLjnjMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMaj[hjF]r€jdX=dirr…r‚}rƒ(jKUjMNjZNj[hjLj}ubaubeubjØ)r„}r…(jKUjLjijMjNjOjÛjQ}r†(jS]jT]jU]jV]jX]ujZMaj[hjF]r‡(j{)rˆ}r‰(jKX)Object-code libraries are installed here.rŠjLj„jMjNjOj~jQ}r‹(jS]jT]jU]jV]jX]ujZM[j[hjF]rŒjdX)Object-code libraries are installed here.r…rŽ}r(jKjŠjMNjZNj[hjLjˆubaubj{)r}r‘(jKXÂIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLj„jMjNjOj~jQ}r’(jS]jT]jU]jV]jX]ujZM]j[hjF]r“(jdXIn the simple build system, r”…r•}r–(jKXIn the simple build system, jMNjZNj[hjLjubj¿)r—}r˜(jKX*dir*jQ}r™(jS]jT]jU]jV]jX]ujLjjF]ršjdXdirr›…rœ}r(jKUjLj—ubajOjÇubjdX+ may contain the following path variables: rž…rŸ}r (jKX+ may contain the following path variables: jMNjZNj[hjLjubj„)r¡}r¢(jKX ``$prefix``jQ}r£(jS]jT]jU]jV]jX]ujLjjF]r¤jdX$prefixr¥…r¦}r§(jKUjLj¡ubajOjŒubjdX, r¨…r©}rª(jKX, r«jMNjZNj[hjLjubj„)r¬}r­(jKX ``$bindir``jQ}r®(jS]jT]jU]jV]jX]ujLjjF]r¯jdX$bindirr°…r±}r²(jKUjLj¬ubajOjŒubjdX, r³…r´}rµ(jKX, jLjubj„)r¶}r·(jKX ``$pkgid``jQ}r¸(jS]jT]jU]jV]jX]ujLjjF]r¹jdX$pkgidrº…r»}r¼(jKUjLj¶ubajOjŒubjdX, r½…r¾}r¿(jKX, jLjubj„)rÀ}rÁ(jKX``$pkg``jQ}rÂ(jS]jT]jU]jV]jX]ujLjjF]rÃjdX$pkgrÄ…rÅ}rÆ(jKUjLjÀubajOjŒubjdX, rÇ…rÈ}rÉ(jKX, rÊjMNjZNj[hjLjubj„)rË}rÌ(jKX ``$version``jQ}rÍ(jS]jT]jU]jV]jX]ujLjjF]rÎjdX$versionrÏ…rÐ}rÑ(jKUjLjËubajOjŒubjdX, rÒ…rÓ}rÔ(jKX, jLjubj„)rÕ}rÖ(jKX ``$compiler``jQ}r×(jS]jT]jU]jV]jX]ujLjjF]rØjdX $compilerrÙ…rÚ}rÛ(jKUjLjÕubajOjŒubjdX, rÜ…rÝ}rÞ(jKX, jLjubj„)rß}rà(jKX``$os``jQ}rá(jS]jT]jU]jV]jX]ujLjjF]râjdX$osrã…rä}rå(jKUjLjßubajOjŒubjdX, ræ…rç}rè(jKX, jLjubj„)ré}rê(jKX ``$arch``jQ}rë(jS]jT]jU]jV]jX]ujLjjF]rìjdX$archrí…rî}rï(jKUjLjéubajOjŒubjdX, rð…rñ}rò(jKj«jLjubj„)ró}rô(jKX``$abi``jQ}rõ(jS]jT]jU]jV]jX]ujLjjF]röjdX$abir÷…rø}rù(jKUjLjóubajOjŒubjdX, rú…rû}rü(jKjÊjLjubj„)rý}rþ(jKX ``$abitag``jQ}rÿ(jS]jT]jU]jV]jX]ujLjjF]rjdX$abitagr…r}r(jKUjLjýubajOjŒubeubeubeubj”)r}r(jKUjLj jMjNjOj—jQ}r(jV]jU]jS]jT]jX]Uentries]r(jšX4setup-configure command line option; --dynlibdir=dirhÚUNtraujZNj[hjF]ubjœ)r }r (jKUjLj jMjNjOjŸjQ}r (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr j¥j ujZNj[hjF]r (j§)r}r(jKX--dynlibdir=dirjLj jMjNjOjªjQ}r(j¬]rX --dynlibdirrajV]rhÚajU]jS]jT]jX]rh2aj²‰ujZMmj[hjF]r(j´)r}r(jKjjLjjMjNjOj·jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMmj[hjF]rjdX --dynlibdirr…r}r(jKUjMNjZNj[hjLjubaubj½)r}r(jKX=dirjLjjMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMmj[hjF]r jdX=dirr!…r"}r#(jKUjMNjZNj[hjLjubaubeubjØ)r$}r%(jKUjLj jMjNjOjÛjQ}r&(jS]jT]jU]jV]jX]ujZMmj[hjF]r'(j{)r(}r)(jKX%Dynamic libraries are installed here.r*jLj$jMjNjOj~jQ}r+(jS]jT]jU]jV]jX]ujZMdj[hjF]r,jdX%Dynamic libraries are installed here.r-…r.}r/(jKj*jMNjZNj[hjLj(ubaubj{)r0}r1(jKX^By default, this is set to `$libdir/$abi`, which is usually not equal to `$libdir/$libsubdir`.jLj$jMjNjOj~jQ}r2(jS]jT]jU]jV]jX]ujZMfj[hjF]r3(jdXBy default, this is set to r4…r5}r6(jKXBy default, this is set to jMNjZNj[hjLj0ubcdocutils.nodes title_reference r7)r8}r9(jKX`$libdir/$abi`jQ}r:(jS]jT]jU]jV]jX]ujLj0jF]r;jdX $libdir/$abir<…r=}r>(jKUjLj8ubajOUtitle_referencer?ubjdX , which is usually not equal to r@…rA}rB(jKX , which is usually not equal to jMNjZNj[hjLj0ubj7)rC}rD(jKX`$libdir/$libsubdir`jQ}rE(jS]jT]jU]jV]jX]ujLj0jF]rFjdX$libdir/$libsubdirrG…rH}rI(jKUjLjCubajOj?ubjdX.…rJ}rK(jKX.jMNjZNj[hjLj0ubeubj{)rL}rM(jKXÏIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLj$jMjNjOj~jQ}rN(jS]jT]jU]jV]jX]ujZMij[hjF]rO(jdXIn the simple build system, rP…rQ}rR(jKXIn the simple build system, jMNjZNj[hjLjLubj¿)rS}rT(jKX*dir*jQ}rU(jS]jT]jU]jV]jX]ujLjLjF]rVjdXdirrW…rX}rY(jKUjLjSubajOjÇubjdX+ may contain the following path variables: rZ…r[}r\(jKX+ may contain the following path variables: jMNjZNj[hjLjLubj„)r]}r^(jKX ``$prefix``jQ}r_(jS]jT]jU]jV]jX]ujLjLjF]r`jdX$prefixra…rb}rc(jKUjLj]ubajOjŒubjdX, rd…re}rf(jKX, rgjMNjZNj[hjLjLubj„)rh}ri(jKX ``$bindir``jQ}rj(jS]jT]jU]jV]jX]ujLjLjF]rkjdX$bindirrl…rm}rn(jKUjLjhubajOjŒubjdX, ro…rp}rq(jKX, jLjLubj„)rr}rs(jKX ``$libdir``jQ}rt(jS]jT]jU]jV]jX]ujLjLjF]rujdX$libdirrv…rw}rx(jKUjLjrubajOjŒubjdX, ry…rz}r{(jKX, jLjLubj„)r|}r}(jKX ``$pkgid``jQ}r~(jS]jT]jU]jV]jX]ujLjLjF]rjdX$pkgidr€…r}r‚(jKUjLj|ubajOjŒubjdX, rƒ…r„}r…(jKX, jLjLubj„)r†}r‡(jKX``$pkg``jQ}rˆ(jS]jT]jU]jV]jX]ujLjLjF]r‰jdX$pkgrŠ…r‹}rŒ(jKUjLj†ubajOjŒubjdX, r…rŽ}r(jKX, rjMNjZNj[hjLjLubj„)r‘}r’(jKX ``$version``jQ}r“(jS]jT]jU]jV]jX]ujLjLjF]r”jdX$versionr•…r–}r—(jKUjLj‘ubajOjŒubjdX, r˜…r™}rš(jKX, jLjLubj„)r›}rœ(jKX ``$compiler``jQ}r(jS]jT]jU]jV]jX]ujLjLjF]ržjdX $compilerrŸ…r }r¡(jKUjLj›ubajOjŒubjdX, r¢…r£}r¤(jKX, jLjLubj„)r¥}r¦(jKX``$os``jQ}r§(jS]jT]jU]jV]jX]ujLjLjF]r¨jdX$osr©…rª}r«(jKUjLj¥ubajOjŒubjdX, r¬…r­}r®(jKX, jLjLubj„)r¯}r°(jKX ``$arch``jQ}r±(jS]jT]jU]jV]jX]ujLjLjF]r²jdX$archr³…r´}rµ(jKUjLj¯ubajOjŒubjdX, r¶…r·}r¸(jKjgjLjLubj„)r¹}rº(jKX``$abi``jQ}r»(jS]jT]jU]jV]jX]ujLjLjF]r¼jdX$abir½…r¾}r¿(jKUjLj¹ubajOjŒubjdX, rÀ…rÁ}rÂ(jKjjLjLubj„)rÃ}rÄ(jKX ``$abitag``jQ}rÅ(jS]jT]jU]jV]jX]ujLjLjF]rÆjdX$abitagrÇ…rÈ}rÉ(jKUjLjÃubajOjŒubeubeubeubj”)rÊ}rË(jKUjLj jMjNjOj—jQ}rÌ(jV]jU]jS]jT]jX]Uentries]rÍ(jšX5setup-configure command line option; --libexecdir=dirh·UNtrÎaujZNj[hjF]ubjœ)rÏ}rÐ(jKUjLj jMjNjOjŸjQ}rÑ(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÒj¥jÒujZNj[hjF]rÓ(j§)rÔ}rÕ(jKX--libexecdir=dirjLjÏjMjNjOjªjQ}rÖ(j¬]r×X --libexecdirrØajV]rÙh·ajU]jS]jT]jX]rÚhaj²‰ujZMwj[hjF]rÛ(j´)rÜ}rÝ(jKjØjLjÔjMjNjOj·jQ}rÞ(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]rßjdX --libexecdirrà…rá}râ(jKUjMNjZNj[hjLjÜubaubj½)rã}rä(jKX=dirjLjÔjMjNjOjÀjQ}rå(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]ræjdX=dirrç…rè}ré(jKUjMNjZNj[hjLjãubaubeubjØ)rê}rë(jKUjLjÏjMjNjOjÛjQ}rì(jS]jT]jU]jV]jX]ujZMwj[hjF]rí(j{)rî}rï(jKXXExecutables that are not expected to be invoked directly by the user are installed here.rðjLjêjMjNjOj~jQ}rñ(jS]jT]jU]jV]jX]ujZMpj[hjF]ròjdXXExecutables that are not expected to be invoked directly by the user are installed here.ró…rô}rõ(jKjðjMNjZNj[hjLjîubaubj{)rö}r÷(jKXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjêjMjNjOj~jQ}rø(jS]jT]jU]jV]jX]ujZMsj[hjF]rù(jdXIn the simple build system, rú…rû}rü(jKXIn the simple build system, jMNjZNj[hjLjöubj¿)rý}rþ(jKX*dir*jQ}rÿ(jS]jT]jU]jV]jX]ujLjöjF]rjdXdirr…r}r(jKUjLjýubajOjÇubjdX+ may contain the following path variables: r…r}r(jKX+ may contain the following path variables: jMNjZNj[hjLjöubj„)r}r(jKX ``$prefix``jQ}r (jS]jT]jU]jV]jX]ujLjöjF]r jdX$prefixr …r }r (jKUjLjubajOjŒubjdX, r…r}r(jKX, rjMNjZNj[hjLjöubj„)r}r(jKX ``$bindir``jQ}r(jS]jT]jU]jV]jX]ujLjöjF]rjdX$bindirr…r}r(jKUjLjubajOjŒubjdX, r…r}r(jKX, jLjöubj„)r}r(jKX ``$libdir``jQ}r(jS]jT]jU]jV]jX]ujLjöjF]rjdX$libdirr …r!}r"(jKUjLjubajOjŒubjdX, r#…r$}r%(jKX, jLjöubj„)r&}r'(jKX``$libsubdir``jQ}r((jS]jT]jU]jV]jX]ujLjöjF]r)jdX $libsubdirr*…r+}r,(jKUjLj&ubajOjŒubjdX, r-…r.}r/(jKX, r0jMNjZNj[hjLjöubj„)r1}r2(jKX ``$pkgid``jQ}r3(jS]jT]jU]jV]jX]ujLjöjF]r4jdX$pkgidr5…r6}r7(jKUjLj1ubajOjŒubjdX, r8…r9}r:(jKX, jLjöubj„)r;}r<(jKX``$pkg``jQ}r=(jS]jT]jU]jV]jX]ujLjöjF]r>jdX$pkgr?…r@}rA(jKUjLj;ubajOjŒubjdX, rB…rC}rD(jKX, jLjöubj„)rE}rF(jKX ``$version``jQ}rG(jS]jT]jU]jV]jX]ujLjöjF]rHjdX$versionrI…rJ}rK(jKUjLjEubajOjŒubjdX, rL…rM}rN(jKX, jLjöubj„)rO}rP(jKX ``$compiler``jQ}rQ(jS]jT]jU]jV]jX]ujLjöjF]rRjdX $compilerrS…rT}rU(jKUjLjOubajOjŒubjdX, rV…rW}rX(jKX, jLjöubj„)rY}rZ(jKX``$os``jQ}r[(jS]jT]jU]jV]jX]ujLjöjF]r\jdX$osr]…r^}r_(jKUjLjYubajOjŒubjdX, r`…ra}rb(jKj0jLjöubj„)rc}rd(jKX ``$arch``jQ}re(jS]jT]jU]jV]jX]ujLjöjF]rfjdX$archrg…rh}ri(jKUjLjcubajOjŒubjdX, rj…rk}rl(jKX, jLjöubj„)rm}rn(jKX``$abi``jQ}ro(jS]jT]jU]jV]jX]ujLjöjF]rpjdX$abirq…rr}rs(jKUjLjmubajOjŒubjdX, rt…ru}rv(jKjjLjöubj„)rw}rx(jKX ``$abitag``jQ}ry(jS]jT]jU]jV]jX]ujLjöjF]rzjdX$abitagr{…r|}r}(jKUjLjwubajOjŒubeubeubeubj”)r~}r(jKUjLj jMjNjOj—jQ}r€(jV]jU]jS]jT]jX]Uentries]r(jšX2setup-configure command line option; --datadir=dirhÜUNtr‚aujZNj[hjF]ubjœ)rƒ}r„(jKUjLj jMjNjOjŸjQ}r…(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr†j¥j†ujZNj[hjF]r‡(j§)rˆ}r‰(jKX --datadir=dirjLjƒjMjNjOjªjQ}rŠ(j¬]r‹X --datadirrŒajV]rhÜajU]jS]jT]jX]rŽh4aj²‰ujZM€j[hjF]r(j´)r}r‘(jKjŒjLjˆjMjNjOj·jQ}r’(j¿jÀjV]jU]jS]jT]jX]ujZM€j[hjF]r“jdX --datadirr”…r•}r–(jKUjMNjZNj[hjLjubaubj½)r—}r˜(jKX=dirjLjˆjMjNjOjÀjQ}r™(j¿jÀjV]jU]jS]jT]jX]ujZM€j[hjF]ršjdX=dirr›…rœ}r(jKUjMNjZNj[hjLj—ubaubeubjØ)rž}rŸ(jKUjLjƒjMjNjOjÛjQ}r (jS]jT]jU]jV]jX]ujZM€j[hjF]r¡(j{)r¢}r£(jKX7Architecture-independent data files are installed here.r¤jLjžjMjNjOj~jQ}r¥(jS]jT]jU]jV]jX]ujZMzj[hjF]r¦jdX7Architecture-independent data files are installed here.r§…r¨}r©(jKj¤jMNjZNj[hjLj¢ubaubj{)rª}r«(jKXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjžjMjNjOj~jQ}r¬(jS]jT]jU]jV]jX]ujZM|j[hjF]r­(jdXIn the simple build system, r®…r¯}r°(jKXIn the simple build system, jMNjZNj[hjLjªubj¿)r±}r²(jKX*dir*jQ}r³(jS]jT]jU]jV]jX]ujLjªjF]r´jdXdirrµ…r¶}r·(jKUjLj±ubajOjÇubjdX+ may contain the following path variables: r¸…r¹}rº(jKX+ may contain the following path variables: jMNjZNj[hjLjªubj„)r»}r¼(jKX ``$prefix``jQ}r½(jS]jT]jU]jV]jX]ujLjªjF]r¾jdX$prefixr¿…rÀ}rÁ(jKUjLj»ubajOjŒubjdX, rÂ…rÃ}rÄ(jKX, rÅjMNjZNj[hjLjªubj„)rÆ}rÇ(jKX ``$bindir``jQ}rÈ(jS]jT]jU]jV]jX]ujLjªjF]rÉjdX$bindirrÊ…rË}rÌ(jKUjLjÆubajOjŒubjdX, rÍ…rÎ}rÏ(jKX, jLjªubj„)rÐ}rÑ(jKX ``$libdir``jQ}rÒ(jS]jT]jU]jV]jX]ujLjªjF]rÓjdX$libdirrÔ…rÕ}rÖ(jKUjLjÐubajOjŒubjdX, r×…rØ}rÙ(jKX, jLjªubj„)rÚ}rÛ(jKX``$libsubdir``jQ}rÜ(jS]jT]jU]jV]jX]ujLjªjF]rÝjdX $libsubdirrÞ…rß}rà(jKUjLjÚubajOjŒubjdX, rá…râ}rã(jKX, räjMNjZNj[hjLjªubj„)rå}ræ(jKX ``$pkgid``jQ}rç(jS]jT]jU]jV]jX]ujLjªjF]rèjdX$pkgidré…rê}rë(jKUjLjåubajOjŒubjdX, rì…rí}rî(jKX, jLjªubj„)rï}rð(jKX``$pkg``jQ}rñ(jS]jT]jU]jV]jX]ujLjªjF]ròjdX$pkgró…rô}rõ(jKUjLjïubajOjŒubjdX, rö…r÷}rø(jKX, jLjªubj„)rù}rú(jKX ``$version``jQ}rû(jS]jT]jU]jV]jX]ujLjªjF]rüjdX$versionrý…rþ}rÿ(jKUjLjùubajOjŒubjdX, r…r}r(jKX, jLjªubj„)r}r(jKX ``$compiler``jQ}r(jS]jT]jU]jV]jX]ujLjªjF]rjdX $compilerr…r}r (jKUjLjubajOjŒubjdX, r …r }r (jKX, jLjªubj„)r }r(jKX``$os``jQ}r(jS]jT]jU]jV]jX]ujLjªjF]rjdX$osr…r}r(jKUjLj ubajOjŒubjdX, r…r}r(jKjäjLjªubj„)r}r(jKX ``$arch``jQ}r(jS]jT]jU]jV]jX]ujLjªjF]rjdX$archr…r}r(jKUjLjubajOjŒubjdX, r…r}r (jKX, jLjªubj„)r!}r"(jKX``$abi``jQ}r#(jS]jT]jU]jV]jX]ujLjªjF]r$jdX$abir%…r&}r'(jKUjLj!ubajOjŒubjdX, r(…r)}r*(jKjÅjLjªubj„)r+}r,(jKX ``$abitag``jQ}r-(jS]jT]jU]jV]jX]ujLjªjF]r.jdX$abitagr/…r0}r1(jKUjLj+ubajOjŒubeubeubeubj”)r2}r3(jKUjLj jMjNjOj—jQ}r4(jV]jU]jS]jT]jX]Uentries]r5(jšX5setup-configure command line option; --sysconfdir=dirjUNtr6aujZNj[hjF]ubjœ)r7}r8(jKUjLj jMjNjOjŸjQ}r9(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr:j¥j:ujZNj[hjF]r;(j§)r<}r=(jKX--sysconfdir=dirjLj7jMjNjOjªjQ}r>(j¬]r?X --sysconfdirr@ajV]rAjajU]jS]jT]jX]rBhzaj²‰ujZM‰j[hjF]rC(j´)rD}rE(jKj@jLj<jMjNjOj·jQ}rF(j¿jÀjV]jU]jS]jT]jX]ujZM‰j[hjF]rGjdX --sysconfdirrH…rI}rJ(jKUjMNjZNj[hjLjDubaubj½)rK}rL(jKX=dirjLj<jMjNjOjÀjQ}rM(j¿jÀjV]jU]jS]jT]jX]ujZM‰j[hjF]rNjdX=dirrO…rP}rQ(jKUjMNjZNj[hjLjKubaubeubjØ)rR}rS(jKUjLj7jMjNjOjÛjQ}rT(jS]jT]jU]jV]jX]ujZM‰j[hjF]rU(j{)rV}rW(jKX3Installation directory for the configuration files.rXjLjRjMjNjOj~jQ}rY(jS]jT]jU]jV]jX]ujZMƒj[hjF]rZjdX3Installation directory for the configuration files.r[…r\}r](jKjXjMNjZNj[hjLjVubaubj{)r^}r_(jKXßIn the simple build system, *dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjRjMjNjOj~jQ}r`(jS]jT]jU]jV]jX]ujZM…j[hjF]ra(jdXIn the simple build system, rb…rc}rd(jKXIn the simple build system, jMNjZNj[hjLj^ubj¿)re}rf(jKX*dir*jQ}rg(jS]jT]jU]jV]jX]ujLj^jF]rhjdXdirri…rj}rk(jKUjLjeubajOjÇubjdX+ may contain the following path variables: rl…rm}rn(jKX+ may contain the following path variables: jMNjZNj[hjLj^ubj„)ro}rp(jKX ``$prefix``jQ}rq(jS]jT]jU]jV]jX]ujLj^jF]rrjdX$prefixrs…rt}ru(jKUjLjoubajOjŒubjdX, rv…rw}rx(jKX, ryjMNjZNj[hjLj^ubj„)rz}r{(jKX ``$bindir``jQ}r|(jS]jT]jU]jV]jX]ujLj^jF]r}jdX$bindirr~…r}r€(jKUjLjzubajOjŒubjdX, r…r‚}rƒ(jKX, jLj^ubj„)r„}r…(jKX ``$libdir``jQ}r†(jS]jT]jU]jV]jX]ujLj^jF]r‡jdX$libdirrˆ…r‰}rŠ(jKUjLj„ubajOjŒubjdX, r‹…rŒ}r(jKX, jLj^ubj„)rŽ}r(jKX``$libsubdir``jQ}r(jS]jT]jU]jV]jX]ujLj^jF]r‘jdX $libsubdirr’…r“}r”(jKUjLjŽubajOjŒubjdX, r•…r–}r—(jKX, r˜jMNjZNj[hjLj^ubj„)r™}rš(jKX ``$pkgid``jQ}r›(jS]jT]jU]jV]jX]ujLj^jF]rœjdX$pkgidr…rž}rŸ(jKUjLj™ubajOjŒubjdX, r …r¡}r¢(jKX, jLj^ubj„)r£}r¤(jKX``$pkg``jQ}r¥(jS]jT]jU]jV]jX]ujLj^jF]r¦jdX$pkgr§…r¨}r©(jKUjLj£ubajOjŒubjdX, rª…r«}r¬(jKX, jLj^ubj„)r­}r®(jKX ``$version``jQ}r¯(jS]jT]jU]jV]jX]ujLj^jF]r°jdX$versionr±…r²}r³(jKUjLj­ubajOjŒubjdX, r´…rµ}r¶(jKX, jLj^ubj„)r·}r¸(jKX ``$compiler``jQ}r¹(jS]jT]jU]jV]jX]ujLj^jF]rºjdX $compilerr»…r¼}r½(jKUjLj·ubajOjŒubjdX, r¾…r¿}rÀ(jKX, jLj^ubj„)rÁ}rÂ(jKX``$os``jQ}rÃ(jS]jT]jU]jV]jX]ujLj^jF]rÄjdX$osrÅ…rÆ}rÇ(jKUjLjÁubajOjŒubjdX, rÈ…rÉ}rÊ(jKj˜jLj^ubj„)rË}rÌ(jKX ``$arch``jQ}rÍ(jS]jT]jU]jV]jX]ujLj^jF]rÎjdX$archrÏ…rÐ}rÑ(jKUjLjËubajOjŒubjdX, rÒ…rÓ}rÔ(jKX, jLj^ubj„)rÕ}rÖ(jKX``$abi``jQ}r×(jS]jT]jU]jV]jX]ujLj^jF]rØjdX$abirÙ…rÚ}rÛ(jKUjLjÕubajOjŒubjdX, rÜ…rÝ}rÞ(jKjyjLj^ubj„)rß}rà(jKX ``$abitag``jQ}rá(jS]jT]jU]jV]jX]ujLj^jF]râjdX$abitagrã…rä}rå(jKUjLjßubajOjŒubeubeubeubj{)ræ}rç(jKXUIn addition the simple build system supports the following installation path options:rèjLj jMjNjOj~jQ}ré(jS]jT]jU]jV]jX]ujZMŠj[hjF]rêjdXUIn addition the simple build system supports the following installation path options:rë…rì}rí(jKjèjMNjZNj[hjLjæubaubj”)rî}rï(jKUjLj jMjNjOj—jQ}rð(jV]jU]jS]jT]jX]Uentries]rñ(jšX4setup-configure command line option; --libsubdir=dirj UNtròaujZNj[hjF]ubjœ)ró}rô(jKUjLj jMjNjOjŸjQ}rõ(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionröj¥jöujZNj[hjF]r÷(j§)rø}rù(jKX--libsubdir=dirjLjójMjNjOjªjQ}rú(j¬]rûX --libsubdirrüajV]rýj ajU]jS]jT]jX]rþh|aj²‰ujZMšj[hjF]rÿ(j´)r}r(jKjüjLjøjMjNjOj·jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMšj[hjF]rjdX --libsubdirr…r}r(jKUjMNjZNj[hjLjubaubj½)r}r(jKX=dirjLjøjMjNjOjÀjQ}r (j¿jÀjV]jU]jS]jT]jX]ujZMšj[hjF]r jdX=dirr …r }r (jKUjMNjZNj[hjLjubaubeubjØ)r}r(jKUjLjójMjNjOjÛjQ}r(jS]jT]jU]jV]jX]ujZMšj[hjF]r(j{)r}r(jKX˜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/``.jLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMj[hjF]r(jdXA subdirectory of r…r}r(jKXA subdirectory of jMNjZNj[hjLjubj¿)r}r(jKX*libdir*jQ}r(jS]jT]jU]jV]jX]ujLjjF]rjdXlibdirr…r}r(jKUjLjubajOjÇubjdXi in which libraries are actually installed. For example, in the simple build system on Unix, the default r …r!}r"(jKXi in which libraries are actually installed. For example, in the simple build system on Unix, the default jMNjZNj[hjLjubj¿)r#}r$(jKX*libdir*jQ}r%(jS]jT]jU]jV]jX]ujLjjF]r&jdXlibdirr'…r(}r)(jKUjLj#ubajOjÇubjdX is r*…r+}r,(jKX is jMNjZNj[hjLjubj„)r-}r.(jKX``/usr/local/lib``jQ}r/(jS]jT]jU]jV]jX]ujLjjF]r0jdX/usr/local/libr1…r2}r3(jKUjLj-ubajOjŒubjdX, and r4…r5}r6(jKX, and jMNjZNj[hjLjubj¿)r7}r8(jKX *libsubdir*jQ}r9(jS]jT]jU]jV]jX]ujLjjF]r:jdX libsubdirr;…r<}r=(jKUjLj7ubajOjÇubjdX8 contains the compiler ABI and package identifier, e.g. r>…r?}r@(jKX8 contains the compiler ABI and package identifier, e.g. jMNjZNj[hjLjubj„)rA}rB(jKX<``x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A``jQ}rC(jS]jT]jU]jV]jX]ujLjjF]rDjdX8x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7ArE…rF}rG(jKUjLjAubajOjŒubjdX%, so libraries would be installed in rH…rI}rJ(jKX%, so libraries would be installed in jMNjZNj[hjLjubj„)rK}rL(jKXL``/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/``jQ}rM(jS]jT]jU]jV]jX]ujLjjF]rNjdXH/usr/local/lib/x86_64-linux-ghc-8.0.2/mypkg-0.1.0-IxQNmCA7qrSEQNkoHSF7A/rO…rP}rQ(jKUjLjKubajOjŒubjdX.…rR}rS(jKX.jMNjZNj[hjLjubeubj{)rT}rU(jKXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjjMjNjOj~jQ}rV(jS]jT]jU]jV]jX]ujZM—j[hjF]rW(j¿)rX}rY(jKX*dir*jQ}rZ(jS]jT]jU]jV]jX]ujLjTjF]r[jdXdirr\…r]}r^(jKUjLjXubajOjÇubjdX+ may contain the following path variables: r_…r`}ra(jKX+ may contain the following path variables: jMNjZNj[hjLjTubj„)rb}rc(jKX ``$pkgid``jQ}rd(jS]jT]jU]jV]jX]ujLjTjF]rejdX$pkgidrf…rg}rh(jKUjLjbubajOjŒubjdX, ri…rj}rk(jKX, rljMNjZNj[hjLjTubj„)rm}rn(jKX``$pkg``jQ}ro(jS]jT]jU]jV]jX]ujLjTjF]rpjdX$pkgrq…rr}rs(jKUjLjmubajOjŒubjdX, rt…ru}rv(jKX, rwjMNjZNj[hjLjTubj„)rx}ry(jKX ``$version``jQ}rz(jS]jT]jU]jV]jX]ujLjTjF]r{jdX$versionr|…r}}r~(jKUjLjxubajOjŒubjdX, r…r€}r(jKX, jLjTubj„)r‚}rƒ(jKX ``$compiler``jQ}r„(jS]jT]jU]jV]jX]ujLjTjF]r…jdX $compilerr†…r‡}rˆ(jKUjLj‚ubajOjŒubjdX, r‰…rŠ}r‹(jKX, jLjTubj„)rŒ}r(jKX``$os``jQ}rŽ(jS]jT]jU]jV]jX]ujLjTjF]rjdX$osr…r‘}r’(jKUjLjŒubajOjŒubjdX, r“…r”}r•(jKX, jLjTubj„)r–}r—(jKX ``$arch``jQ}r˜(jS]jT]jU]jV]jX]ujLjTjF]r™jdX$archrš…r›}rœ(jKUjLj–ubajOjŒubjdX, r…rž}rŸ(jKjwjLjTubj„)r }r¡(jKX``$abi``jQ}r¢(jS]jT]jU]jV]jX]ujLjTjF]r£jdX$abir¤…r¥}r¦(jKUjLj ubajOjŒubjdX, r§…r¨}r©(jKjljLjTubj„)rª}r«(jKX ``$abitag``jQ}r¬(jS]jT]jU]jV]jX]ujLjTjF]r­jdX$abitagr®…r¯}r°(jKUjLjªubajOjŒubeubeubeubj”)r±}r²(jKUjLj jMjNjOj—jQ}r³(jV]jU]jS]jT]jX]Uentries]r´(jšX8setup-configure command line option; --libexecsubdir=dirhÖUNtrµaujZNj[hjF]ubjœ)r¶}r·(jKUjLj jMjNjOjŸjQ}r¸(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr¹j¥j¹ujZNj[hjF]rº(j§)r»}r¼(jKX--libexecsubdir=dirjLj¶jMjNjOjªjQ}r½(j¬]r¾X--libexecsubdirr¿ajV]rÀhÖajU]jS]jT]jX]rÁh.aj²‰ujZM¦j[hjF]rÂ(j´)rÃ}rÄ(jKj¿jLj»jMjNjOj·jQ}rÅ(j¿jÀjV]jU]jS]jT]jX]ujZM¦j[hjF]rÆjdX--libexecsubdirrÇ…rÈ}rÉ(jKUjMNjZNj[hjLjÃubaubj½)rÊ}rË(jKX=dirjLj»jMjNjOjÀjQ}rÌ(j¿jÀjV]jU]jS]jT]jX]ujZM¦j[hjF]rÍjdX=dirrÎ…rÏ}rÐ(jKUjMNjZNj[hjLjÊubaubeubjØ)rÑ}rÒ(jKUjLj¶jMjNjOjÛjQ}rÓ(jS]jT]jU]jV]jX]ujZM¦j[hjF]rÔ(j{)rÕ}rÖ(jKXRA 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/``jLjÑjMjNjOj~jQ}r×(jS]jT]jU]jV]jX]ujZMj[hjF]rØ(jdXA subdirectory of rÙ…rÚ}rÛ(jKXA subdirectory of jMNjZNj[hjLjÕubj¿)rÜ}rÝ(jKX *libexecdir*jQ}rÞ(jS]jT]jU]jV]jX]ujLjÕjF]rßjdX libexecdirrà…rá}râ(jKUjLjÜubajOjÇubjdXj in which private executables are installed. For example, in the simple build system on Unix, the default rã…rä}rå(jKXj in which private executables are installed. For example, in the simple build system on Unix, the default jMNjZNj[hjLjÕubj¿)ræ}rç(jKX *libexecdir*jQ}rè(jS]jT]jU]jV]jX]ujLjÕjF]réjdX libexecdirrê…rë}rì(jKUjLjæubajOjÇubjdX is rí…rî}rï(jKX is jMNjZNj[hjLjÕubj„)rð}rñ(jKX``/usr/local/libexec``jQ}rò(jS]jT]jU]jV]jX]ujLjÕjF]rójdX/usr/local/libexecrô…rõ}rö(jKUjLjðubajOjŒubjdX, and r÷…rø}rù(jKX, and jMNjZNj[hjLjÕubj¿)rú}rû(jKX *libsubdir*jQ}rü(jS]jT]jU]jV]jX]ujLjÕjF]rýjdX libsubdirrþ…rÿ}r(jKUjLjúubajOjÇubjdX is r…r}r(jKX is jMNjZNj[hjLjÕubj„)r}r(jKX&``x86_64-linux-ghc-8.0.2/mypkg-0.1.0``jQ}r(jS]jT]jU]jV]jX]ujLjÕjF]rjdX"x86_64-linux-ghc-8.0.2/mypkg-0.1.0r…r }r (jKUjLjubajOjŒubjdX/, so private executables would be installed in r …r }r (jKX/, so private executables would be installed in jMNjZNj[hjLjÕubj„)r}r(jKX:``/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/``jQ}r(jS]jT]jU]jV]jX]ujLjÕjF]rjdX6/usr/local/libexec/x86_64-linux-ghc-8.0.2/mypkg-0.1.0/r…r}r(jKUjLjubajOjŒubeubj{)r}r(jKXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjÑjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM£j[hjF]r(j¿)r}r(jKX*dir*jQ}r(jS]jT]jU]jV]jX]ujLjjF]rjdXdirr…r}r(jKUjLjubajOjÇubjdX+ may contain the following path variables: r …r!}r"(jKX+ may contain the following path variables: jMNjZNj[hjLjubj„)r#}r$(jKX ``$pkgid``jQ}r%(jS]jT]jU]jV]jX]ujLjjF]r&jdX$pkgidr'…r(}r)(jKUjLj#ubajOjŒubjdX, r*…r+}r,(jKX, r-jMNjZNj[hjLjubj„)r.}r/(jKX``$pkg``jQ}r0(jS]jT]jU]jV]jX]ujLjjF]r1jdX$pkgr2…r3}r4(jKUjLj.ubajOjŒubjdX, r5…r6}r7(jKX, r8jMNjZNj[hjLjubj„)r9}r:(jKX ``$version``jQ}r;(jS]jT]jU]jV]jX]ujLjjF]r<jdX$versionr=…r>}r?(jKUjLj9ubajOjŒubjdX, r@…rA}rB(jKX, jLjubj„)rC}rD(jKX ``$compiler``jQ}rE(jS]jT]jU]jV]jX]ujLjjF]rFjdX $compilerrG…rH}rI(jKUjLjCubajOjŒubjdX, rJ…rK}rL(jKX, jLjubj„)rM}rN(jKX``$os``jQ}rO(jS]jT]jU]jV]jX]ujLjjF]rPjdX$osrQ…rR}rS(jKUjLjMubajOjŒubjdX, rT…rU}rV(jKX, jLjubj„)rW}rX(jKX ``$arch``jQ}rY(jS]jT]jU]jV]jX]ujLjjF]rZjdX$archr[…r\}r](jKUjLjWubajOjŒubjdX, r^…r_}r`(jKj8jLjubj„)ra}rb(jKX``$abi``jQ}rc(jS]jT]jU]jV]jX]ujLjjF]rdjdX$abire…rf}rg(jKUjLjaubajOjŒubjdX, rh…ri}rj(jKj-jLjubj„)rk}rl(jKX ``$abitag``jQ}rm(jS]jT]jU]jV]jX]ujLjjF]rnjdX$abitagro…rp}rq(jKUjLjkubajOjŒubeubeubeubj”)rr}rs(jKUjLj jMjNjOj—jQ}rt(jV]jU]jS]jT]jX]Uentries]ru(jšX5setup-configure command line option; --datasubdir=dirjUNtrvaujZNj[hjF]ubjœ)rw}rx(jKUjLj jMjNjOjŸjQ}ry(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrzj¥jzujZNj[hjF]r{(j§)r|}r}(jKX--datasubdir=dirjLjwjMjNjOjªjQ}r~(j¬]rX --datasubdirr€ajV]rjajU]jS]jT]jX]r‚h`aj²‰ujZM¯j[hjF]rƒ(j´)r„}r…(jKj€jLj|jMjNjOj·jQ}r†(j¿jÀjV]jU]jS]jT]jX]ujZM¯j[hjF]r‡jdX --datasubdirrˆ…r‰}rŠ(jKUjMNjZNj[hjLj„ubaubj½)r‹}rŒ(jKX=dirjLj|jMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZM¯j[hjF]rŽjdX=dirr…r}r‘(jKUjMNjZNj[hjLj‹ubaubeubjØ)r’}r“(jKUjLjwjMjNjOjÛjQ}r”(jS]jT]jU]jV]jX]ujZM¯j[hjF]r•(j{)r–}r—(jKXGA subdirectory of *datadir* in which data files are actually installed.jLj’jMjNjOj~jQ}r˜(jS]jT]jU]jV]jX]ujZM©j[hjF]r™(jdXA subdirectory of rš…r›}rœ(jKXA subdirectory of jMNjZNj[hjLj–ubj¿)r}rž(jKX *datadir*jQ}rŸ(jS]jT]jU]jV]jX]ujLj–jF]r jdXdatadirr¡…r¢}r£(jKUjLjubajOjÇubjdX, in which data files are actually installed.r¤…r¥}r¦(jKX, in which data files are actually installed.jMNjZNj[hjLj–ubeubj{)r§}r¨(jKXŒ*dir* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLj’jMjNjOj~jQ}r©(jS]jT]jU]jV]jX]ujZM¬j[hjF]rª(j¿)r«}r¬(jKX*dir*jQ}r­(jS]jT]jU]jV]jX]ujLj§jF]r®jdXdirr¯…r°}r±(jKUjLj«ubajOjÇubjdX+ may contain the following path variables: r²…r³}r´(jKX+ may contain the following path variables: jMNjZNj[hjLj§ubj„)rµ}r¶(jKX ``$pkgid``jQ}r·(jS]jT]jU]jV]jX]ujLj§jF]r¸jdX$pkgidr¹…rº}r»(jKUjLjµubajOjŒubjdX, r¼…r½}r¾(jKX, r¿jMNjZNj[hjLj§ubj„)rÀ}rÁ(jKX``$pkg``jQ}rÂ(jS]jT]jU]jV]jX]ujLj§jF]rÃjdX$pkgrÄ…rÅ}rÆ(jKUjLjÀubajOjŒubjdX, rÇ…rÈ}rÉ(jKX, rÊjMNjZNj[hjLj§ubj„)rË}rÌ(jKX ``$version``jQ}rÍ(jS]jT]jU]jV]jX]ujLj§jF]rÎjdX$versionrÏ…rÐ}rÑ(jKUjLjËubajOjŒubjdX, rÒ…rÓ}rÔ(jKX, jLj§ubj„)rÕ}rÖ(jKX ``$compiler``jQ}r×(jS]jT]jU]jV]jX]ujLj§jF]rØjdX $compilerrÙ…rÚ}rÛ(jKUjLjÕubajOjŒubjdX, rÜ…rÝ}rÞ(jKX, jLj§ubj„)rß}rà(jKX``$os``jQ}rá(jS]jT]jU]jV]jX]ujLj§jF]râjdX$osrã…rä}rå(jKUjLjßubajOjŒubjdX, ræ…rç}rè(jKX, jLj§ubj„)ré}rê(jKX ``$arch``jQ}rë(jS]jT]jU]jV]jX]ujLj§jF]rìjdX$archrí…rî}rï(jKUjLjéubajOjŒubjdX, rð…rñ}rò(jKjÊjLj§ubj„)ró}rô(jKX``$abi``jQ}rõ(jS]jT]jU]jV]jX]ujLj§jF]röjdX$abir÷…rø}rù(jKUjLjóubajOjŒubjdX, rú…rû}rü(jKj¿jLj§ubj„)rý}rþ(jKX ``$abitag``jQ}rÿ(jS]jT]jU]jV]jX]ujLj§jF]rjdX$abitagr…r}r(jKUjLjýubajOjŒubeubeubeubj”)r}r(jKUjLj jMjNjOj—jQ}r(jV]jU]jS]jT]jX]Uentries]r(jšX1setup-configure command line option; --docdir=dirj.UNtraujZNj[hjF]ubjœ)r }r (jKUjLj jMjNjOjŸjQ}r (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr j¥j ujZNj[hjF]r (j§)r}r(jKX --docdir=dirjLj jMjNjOjªjQ}r(j¬]rX--docdirrajV]rj.ajU]jS]jT]jX]rhŒaj²‰ujZM¸j[hjF]r(j´)r}r(jKjjLjjMjNjOj·jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]rjdX--docdirr…r}r(jKUjMNjZNj[hjLjubaubj½)r}r(jKX=dirjLjjMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]r jdX=dirr!…r"}r#(jKUjMNjZNj[hjLjubaubeubjØ)r$}r%(jKUjLj jMjNjOjÛjQ}r&(jS]jT]jU]jV]jX]ujZM¸j[hjF]r'(j{)r(}r)(jKX=Documentation files are installed relative to this directory.r*jLj$jMjNjOj~jQ}r+(jS]jT]jU]jV]jX]ujZM²j[hjF]r,jdX=Documentation files are installed relative to this directory.r-…r.}r/(jKj*jMNjZNj[hjLj(ubaubj{)r0}r1(jKXâ*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLj$jMjNjOj~jQ}r2(jS]jT]jU]jV]jX]ujZM´j[hjF]r3(j¿)r4}r5(jKX*dir*jQ}r6(jS]jT]jU]jV]jX]ujLj0jF]r7jdXdirr8…r9}r:(jKUjLj4ubajOjÇubjdX+ may contain the following path variables: r;…r<}r=(jKX+ may contain the following path variables: jMNjZNj[hjLj0ubj„)r>}r?(jKX ``$prefix``jQ}r@(jS]jT]jU]jV]jX]ujLj0jF]rAjdX$prefixrB…rC}rD(jKUjLj>ubajOjŒubjdX, rE…rF}rG(jKX, rHjMNjZNj[hjLj0ubj„)rI}rJ(jKX ``$bindir``jQ}rK(jS]jT]jU]jV]jX]ujLj0jF]rLjdX$bindirrM…rN}rO(jKUjLjIubajOjŒubjdX, rP…rQ}rR(jKX, rSjMNjZNj[hjLj0ubj„)rT}rU(jKX ``$libdir``jQ}rV(jS]jT]jU]jV]jX]ujLj0jF]rWjdX$libdirrX…rY}rZ(jKUjLjTubajOjŒubjdX, r[…r\}r](jKX, jLj0ubj„)r^}r_(jKX``$libsubdir``jQ}r`(jS]jT]jU]jV]jX]ujLj0jF]rajdX $libsubdirrb…rc}rd(jKUjLj^ubajOjŒubjdX, re…rf}rg(jKX, jLj0ubj„)rh}ri(jKX ``$datadir``jQ}rj(jS]jT]jU]jV]jX]ujLj0jF]rkjdX$datadirrl…rm}rn(jKUjLjhubajOjŒubjdX, ro…rp}rq(jKX, jLj0ubj„)rr}rs(jKX``$datasubdir``jQ}rt(jS]jT]jU]jV]jX]ujLj0jF]rujdX $datasubdirrv…rw}rx(jKUjLjrubajOjŒubjdX, ry…rz}r{(jKX, jLj0ubj„)r|}r}(jKX ``$pkgid``jQ}r~(jS]jT]jU]jV]jX]ujLj0jF]rjdX$pkgidr€…r}r‚(jKUjLj|ubajOjŒubjdX, rƒ…r„}r…(jKX, jLj0ubj„)r†}r‡(jKX``$pkg``jQ}rˆ(jS]jT]jU]jV]jX]ujLj0jF]r‰jdX$pkgrŠ…r‹}rŒ(jKUjLj†ubajOjŒubjdX, r…rŽ}r(jKX, jLj0ubj„)r}r‘(jKX ``$version``jQ}r’(jS]jT]jU]jV]jX]ujLj0jF]r“jdX$versionr”…r•}r–(jKUjLjubajOjŒubjdX, r—…r˜}r™(jKX, jLj0ubj„)rš}r›(jKX ``$compiler``jQ}rœ(jS]jT]jU]jV]jX]ujLj0jF]rjdX $compilerrž…rŸ}r (jKUjLjšubajOjŒubjdX, r¡…r¢}r£(jKjHjLj0ubj„)r¤}r¥(jKX``$os``jQ}r¦(jS]jT]jU]jV]jX]ujLj0jF]r§jdX$osr¨…r©}rª(jKUjLj¤ubajOjŒubjdX, r«…r¬}r­(jKX, jLj0ubj„)r®}r¯(jKX ``$arch``jQ}r°(jS]jT]jU]jV]jX]ujLj0jF]r±jdX$archr²…r³}r´(jKUjLj®ubajOjŒubjdX, rµ…r¶}r·(jKX, jLj0ubj„)r¸}r¹(jKX``$abi``jQ}rº(jS]jT]jU]jV]jX]ujLj0jF]r»jdX$abir¼…r½}r¾(jKUjLj¸ubajOjŒubjdX, r¿…rÀ}rÁ(jKjSjLj0ubj„)rÂ}rÃ(jKX ``$abitag``jQ}rÄ(jS]jT]jU]jV]jX]ujLj0jF]rÅjdX$abitagrÆ…rÇ}rÈ(jKUjLjÂubajOjŒubeubeubeubj”)rÉ}rÊ(jKUjLj jMjNjOj—jQ}rË(jV]jU]jS]jT]jX]Uentries]rÌ(jšX2setup-configure command line option; --htmldir=dirhÛUNtrÍaujZNj[hjF]ubjœ)rÎ}rÏ(jKUjLj jMjNjOjŸjQ}rÐ(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÑj¥jÑujZNj[hjF]rÒ(j§)rÓ}rÔ(jKX --htmldir=dirjLjÎjMjNjOjªjQ}rÕ(j¬]rÖX --htmldirr×ajV]rØhÛajU]jS]jT]jX]rÙh3aj²‰ujZMÁj[hjF]rÚ(j´)rÛ}rÜ(jKj×jLjÓjMjNjOj·jQ}rÝ(j¿jÀjV]jU]jS]jT]jX]ujZMÁj[hjF]rÞjdX --htmldirrß…rà}rá(jKUjMNjZNj[hjLjÛubaubj½)râ}rã(jKX=dirjLjÓjMjNjOjÀjQ}rä(j¿jÀjV]jU]jS]jT]jX]ujZMÁj[hjF]råjdX=dirræ…rç}rè(jKUjMNjZNj[hjLjâubaubeubjØ)ré}rê(jKUjLjÎjMjNjOjÛjQ}rë(jS]jT]jU]jV]jX]ujZMÁj[hjF]rì(j{)rí}rî(jKXBHTML documentation files are installed relative to this directory.rïjLjéjMjNjOj~jQ}rð(jS]jT]jU]jV]jX]ujZM»j[hjF]rñjdXBHTML documentation files are installed relative to this directory.rò…ró}rô(jKjïjMNjZNj[hjLjíubaubj{)rõ}rö(jKXï*dir* may contain the following path variables: ``$prefix``, ``$bindir``, ``$libdir``, ``$libsubdir``, ``$datadir``, ``$datasubdir``, ``$docdir``, ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjéjMjNjOj~jQ}r÷(jS]jT]jU]jV]jX]ujZM½j[hjF]rø(j¿)rù}rú(jKX*dir*jQ}rû(jS]jT]jU]jV]jX]ujLjõjF]rüjdXdirrý…rþ}rÿ(jKUjLjùubajOjÇubjdX+ may contain the following path variables: r…r}r(jKX+ may contain the following path variables: jMNjZNj[hjLjõubj„)r}r(jKX ``$prefix``jQ}r(jS]jT]jU]jV]jX]ujLjõjF]rjdX$prefixr…r}r (jKUjLjubajOjŒubjdX, r …r }r (jKX, r jMNjZNj[hjLjõubj„)r}r(jKX ``$bindir``jQ}r(jS]jT]jU]jV]jX]ujLjõjF]rjdX$bindirr…r}r(jKUjLjubajOjŒubjdX, r…r}r(jKX, rjMNjZNj[hjLjõubj„)r}r(jKX ``$libdir``jQ}r(jS]jT]jU]jV]jX]ujLjõjF]rjdX$libdirr…r}r(jKUjLjubajOjŒubjdX, r …r!}r"(jKX, jLjõubj„)r#}r$(jKX``$libsubdir``jQ}r%(jS]jT]jU]jV]jX]ujLjõjF]r&jdX $libsubdirr'…r(}r)(jKUjLj#ubajOjŒubjdX, r*…r+}r,(jKX, jLjõubj„)r-}r.(jKX ``$datadir``jQ}r/(jS]jT]jU]jV]jX]ujLjõjF]r0jdX$datadirr1…r2}r3(jKUjLj-ubajOjŒubjdX, r4…r5}r6(jKX, jLjõubj„)r7}r8(jKX``$datasubdir``jQ}r9(jS]jT]jU]jV]jX]ujLjõjF]r:jdX $datasubdirr;…r<}r=(jKUjLj7ubajOjŒubjdX, r>…r?}r@(jKX, jLjõubj„)rA}rB(jKX ``$docdir``jQ}rC(jS]jT]jU]jV]jX]ujLjõjF]rDjdX$docdirrE…rF}rG(jKUjLjAubajOjŒubjdX, rH…rI}rJ(jKX, jLjõubj„)rK}rL(jKX ``$pkgid``jQ}rM(jS]jT]jU]jV]jX]ujLjõjF]rNjdX$pkgidrO…rP}rQ(jKUjLjKubajOjŒubjdX, rR…rS}rT(jKX, jLjõubj„)rU}rV(jKX``$pkg``jQ}rW(jS]jT]jU]jV]jX]ujLjõjF]rXjdX$pkgrY…rZ}r[(jKUjLjUubajOjŒubjdX, r\…r]}r^(jKX, jLjõubj„)r_}r`(jKX ``$version``jQ}ra(jS]jT]jU]jV]jX]ujLjõjF]rbjdX$versionrc…rd}re(jKUjLj_ubajOjŒubjdX, rf…rg}rh(jKj jLjõubj„)ri}rj(jKX ``$compiler``jQ}rk(jS]jT]jU]jV]jX]ujLjõjF]rljdX $compilerrm…rn}ro(jKUjLjiubajOjŒubjdX, rp…rq}rr(jKX, jLjõubj„)rs}rt(jKX``$os``jQ}ru(jS]jT]jU]jV]jX]ujLjõjF]rvjdX$osrw…rx}ry(jKUjLjsubajOjŒubjdX, rz…r{}r|(jKX, jLjõubj„)r}}r~(jKX ``$arch``jQ}r(jS]jT]jU]jV]jX]ujLjõjF]r€jdX$archr…r‚}rƒ(jKUjLj}ubajOjŒubjdX, r„…r…}r†(jKX, jLjõubj„)r‡}rˆ(jKX``$abi``jQ}r‰(jS]jT]jU]jV]jX]ujLjõjF]rŠjdX$abir‹…rŒ}r(jKUjLj‡ubajOjŒubjdX, rŽ…r}r(jKjjLjõubj„)r‘}r’(jKX ``$abitag``jQ}r“(jS]jT]jU]jV]jX]ujLjõjF]r”jdX$abitagr•…r–}r—(jKUjLj‘ubajOjŒubeubeubeubj”)r˜}r™(jKUjLj jMjNjOj—jQ}rš(jV]jU]jS]jT]jX]Uentries]r›(jšX<setup-configure command line option; --program-prefix=prefixhÝUNtrœaujZNj[hjF]ubjœ)r}rž(jKUjLj jMjNjOjŸjQ}rŸ(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr j¥j ujZNj[hjF]r¡(j§)r¢}r£(jKX--program-prefix=prefixjLjjMjNjOjªjQ}r¤(j¬]r¥X--program-prefixr¦ajV]r§hÝajU]jS]jT]jX]r¨h5aj²‰ujZMÉj[hjF]r©(j´)rª}r«(jKj¦jLj¢jMjNjOj·jQ}r¬(j¿jÀjV]jU]jS]jT]jX]ujZMÉj[hjF]r­jdX--program-prefixr®…r¯}r°(jKUjMNjZNj[hjLjªubaubj½)r±}r²(jKX=prefixjLj¢jMjNjOjÀjQ}r³(j¿jÀjV]jU]jS]jT]jX]ujZMÉj[hjF]r´jdX=prefixrµ…r¶}r·(jKUjMNjZNj[hjLj±ubaubeubjØ)r¸}r¹(jKUjLjjMjNjOjÛjQ}rº(jS]jT]jU]jV]jX]ujZMÉj[hjF]r»(j{)r¼}r½(jKX,Prepend *prefix* to installed program names.jLj¸jMjNjOj~jQ}r¾(jS]jT]jU]jV]jX]ujZMÄj[hjF]r¿(jdXPrepend rÀ…rÁ}rÂ(jKXPrepend jMNjZNj[hjLj¼ubj¿)rÃ}rÄ(jKX*prefix*jQ}rÅ(jS]jT]jU]jV]jX]ujLj¼jF]rÆjdXprefixrÇ…rÈ}rÉ(jKUjLjÃubajOjÇubjdX to installed program names.rÊ…rË}rÌ(jKX to installed program names.jMNjZNj[hjLj¼ubeubj{)rÍ}rÎ(jKX*prefix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLj¸jMjNjOj~jQ}rÏ(jS]jT]jU]jV]jX]ujZMÆj[hjF]rÐ(j¿)rÑ}rÒ(jKX*prefix*jQ}rÓ(jS]jT]jU]jV]jX]ujLjÍjF]rÔjdXprefixrÕ…rÖ}r×(jKUjLjÑubajOjÇubjdX+ may contain the following path variables: rØ…rÙ}rÚ(jKX+ may contain the following path variables: jMNjZNj[hjLjÍubj„)rÛ}rÜ(jKX ``$pkgid``jQ}rÝ(jS]jT]jU]jV]jX]ujLjÍjF]rÞjdX$pkgidrß…rà}rá(jKUjLjÛubajOjŒubjdX, râ…rã}rä(jKX, råjMNjZNj[hjLjÍubj„)ræ}rç(jKX``$pkg``jQ}rè(jS]jT]jU]jV]jX]ujLjÍjF]réjdX$pkgrê…rë}rì(jKUjLjæubajOjŒubjdX, rí…rî}rï(jKX, rðjMNjZNj[hjLjÍubj„)rñ}rò(jKX ``$version``jQ}ró(jS]jT]jU]jV]jX]ujLjÍjF]rôjdX$versionrõ…rö}r÷(jKUjLjñubajOjŒubjdX, rø…rù}rú(jKX, jLjÍubj„)rû}rü(jKX ``$compiler``jQ}rý(jS]jT]jU]jV]jX]ujLjÍjF]rþjdX $compilerrÿ…r}r(jKUjLjûubajOjŒubjdX, r…r}r(jKX, jLjÍubj„)r}r(jKX``$os``jQ}r(jS]jT]jU]jV]jX]ujLjÍjF]rjdX$osr …r }r (jKUjLjubajOjŒubjdX, r …r }r(jKX, jLjÍubj„)r}r(jKX ``$arch``jQ}r(jS]jT]jU]jV]jX]ujLjÍjF]rjdX$archr…r}r(jKUjLjubajOjŒubjdX, r…r}r(jKjðjLjÍubj„)r}r(jKX``$abi``jQ}r(jS]jT]jU]jV]jX]ujLjÍjF]rjdX$abir…r}r(jKUjLjubajOjŒubjdX, r …r!}r"(jKjåjLjÍubj„)r#}r$(jKX ``$abitag``jQ}r%(jS]jT]jU]jV]jX]ujLjÍjF]r&jdX$abitagr'…r(}r)(jKUjLj#ubajOjŒubeubeubeubj”)r*}r+(jKUjLj jMjNjOj—jQ}r,(jV]jU]jS]jT]jX]Uentries]r-(jšX<setup-configure command line option; --program-suffix=suffixj/UNtr.aujZNj[hjF]ubjœ)r/}r0(jKUjLj jMjNjOjŸjQ}r1(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr2j¥j2ujZNj[hjF]r3(j§)r4}r5(jKX--program-suffix=suffixjLj/jMjNjOjªjQ}r6(j¬]r7X--program-suffixr8ajV]r9j/ajU]jS]jT]jX]r:haj²‰ujZMÔj[hjF]r;(j´)r<}r=(jKj8jLj4jMjNjOj·jQ}r>(j¿jÀjV]jU]jS]jT]jX]ujZMÔj[hjF]r?jdX--program-suffixr@…rA}rB(jKUjMNjZNj[hjLj<ubaubj½)rC}rD(jKX=suffixjLj4jMjNjOjÀjQ}rE(j¿jÀjV]jU]jS]jT]jX]ujZMÔj[hjF]rFjdX=suffixrG…rH}rI(jKUjMNjZNj[hjLjCubaubeubjØ)rJ}rK(jKUjLj/jMjNjOjÛjQ}rL(jS]jT]jU]jV]jX]ujZMÔj[hjF]rM(j{)rN}rO(jKXÚ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'``.jLjJjMjNjOj~jQ}rP(jS]jT]jU]jV]jX]ujZMÌj[hjF]rQ(jdXAppend rR…rS}rT(jKXAppend jMNjZNj[hjLjNubj¿)rU}rV(jKX*suffix*jQ}rW(jS]jT]jU]jV]jX]ujLjNjF]rXjdXsuffixrY…rZ}r[(jKUjLjUubajOjÇubjdX­ 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\…r]}r^(jKX« 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: jMNjZNj[hjLjNubj„)r_}r`(jKX``--program-suffix='$version'``jQ}ra(jS]jT]jU]jV]jX]ujLjNjF]rbjdX--program-suffix='$version'rc…rd}re(jKUjLj_ubajOjŒubjdX.…rf}rg(jKX.jMNjZNj[hjLjNubeubj{)rh}ri(jKX*suffix* may contain the following path variables: ``$pkgid``, ``$pkg``, ``$version``, ``$compiler``, ``$os``, ``$arch``, ``$abi``, ``$abitag``jLjJjMjNjOj~jQ}rj(jS]jT]jU]jV]jX]ujZMÑj[hjF]rk(j¿)rl}rm(jKX*suffix*jQ}rn(jS]jT]jU]jV]jX]ujLjhjF]rojdXsuffixrp…rq}rr(jKUjLjlubajOjÇubjdX+ may contain the following path variables: rs…rt}ru(jKX+ may contain the following path variables: jMNjZNj[hjLjhubj„)rv}rw(jKX ``$pkgid``jQ}rx(jS]jT]jU]jV]jX]ujLjhjF]ryjdX$pkgidrz…r{}r|(jKUjLjvubajOjŒubjdX, r}…r~}r(jKX, r€jMNjZNj[hjLjhubj„)r}r‚(jKX``$pkg``jQ}rƒ(jS]jT]jU]jV]jX]ujLjhjF]r„jdX$pkgr……r†}r‡(jKUjLjubajOjŒubjdX, rˆ…r‰}rŠ(jKX, r‹jMNjZNj[hjLjhubj„)rŒ}r(jKX ``$version``jQ}rŽ(jS]jT]jU]jV]jX]ujLjhjF]rjdX$versionr…r‘}r’(jKUjLjŒubajOjŒubjdX, r“…r”}r•(jKX, jLjhubj„)r–}r—(jKX ``$compiler``jQ}r˜(jS]jT]jU]jV]jX]ujLjhjF]r™jdX $compilerrš…r›}rœ(jKUjLj–ubajOjŒubjdX, r…rž}rŸ(jKX, jLjhubj„)r }r¡(jKX``$os``jQ}r¢(jS]jT]jU]jV]jX]ujLjhjF]r£jdX$osr¤…r¥}r¦(jKUjLj ubajOjŒubjdX, r§…r¨}r©(jKX, jLjhubj„)rª}r«(jKX ``$arch``jQ}r¬(jS]jT]jU]jV]jX]ujLjhjF]r­jdX$archr®…r¯}r°(jKUjLjªubajOjŒubjdX, r±…r²}r³(jKj‹jLjhubj„)r´}rµ(jKX``$abi``jQ}r¶(jS]jT]jU]jV]jX]ujLjhjF]r·jdX$abir¸…r¹}rº(jKUjLj´ubajOjŒubjdX, r»…r¼}r½(jKj€jLjhubj„)r¾}r¿(jKX ``$abitag``jQ}rÀ(jS]jT]jU]jV]jX]ujLjhjF]rÁjdX$abitagrÂ…rÃ}rÄ(jKUjLj¾ubajOjŒubeubeubeubjH)rÅ}rÆ(jKUjLj jMjNjOjPjQ}rÇ(jS]jT]jU]jV]rÈhÞajX]rÉh6aujZMÖj[hjF]rÊ(j])rË}rÌ(jKX)Path variables in the simple build systemrÍjLjÅjMjNjOjajQ}rÎ(jS]jT]jU]jV]jX]ujZMÖj[hjF]rÏjdX)Path variables in the simple build systemrÐ…rÑ}rÒ(jKjÍjMNjZNj[hjLjËubaubj{)rÓ}rÔ(jKX»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>`__).jLjÅjMjNjOj~jQ}rÕ(jS]jT]jU]jV]jX]ujZMØj[hjF]rÖ(jdXì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Ù(jKXì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 jMNjZNj[hjLjÓubj„)rÚ}rÛ(jKX ``$prefix``jQ}rÜ(jS]jT]jU]jV]jX]ujLjÓjF]rÝjdX$prefixrÞ…rß}rà(jKUjLjÚubajOjŒubjdX”. 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ã(jKX”. This allows paths to be specified relative to each other rather than as absolute paths, which is important for building relocatable packages (see jMNjZNj[hjLjÓubjž)rä}rå(jKX.`prefix independence <#prefix-independence>`__jQ}ræ(UnameXprefix independencejìX#prefix-independencejV]jU]jS]jT]jX]ujLjÓjF]rçjdXprefix independencerè…ré}rê(jKUjLjäubajOj§ubjdX).rë…rì}rí(jKX).jMNjZNj[hjLjÓubeubcdocutils.nodes definition_list rî)rï}rð(jKUjLjÅjMjNjOUdefinition_listrñjQ}rò(jS]jT]jU]jV]jX]ujZNj[hjF]ró(cdocutils.nodes definition_list_item rô)rõ}rö(jKX¹$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.jLjïjMjNjOUdefinition_list_itemr÷jQ}rø(jS]jT]jU]jV]jX]ujZMâjF]rù(cdocutils.nodes term rú)rû}rü(jKX$prefixrýjLjõjMjNjOUtermrþjQ}rÿ(jS]jT]jU]jV]jX]ujZMâjF]rjdX$prefixr…r}r(jKjýjLjûubaubcdocutils.nodes definition r)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjõjF]rj{)r }r (jKX±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.jLjjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZMájF]r (jdXœ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(jKXœ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 jLj ubj„)r}r(jKX ``$prefix``jQ}r(jS]jT]jU]jV]jX]ujLj jF]rjdX$prefixr…r}r(jKUjLjubajOjŒubjdX variable.r…r}r(jKX variable.jLj ubeubajOU definitionrubeubjô)r}r(jKXu$bindir The path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jLjïjMjNjOj÷jQ}r(jS]jT]jU]jV]jX]ujZMåj[hjF]r(jú)r}r (jKX$bindirr!jLjjMjNjOjþjQ}r"(jS]jT]jU]jV]jX]ujZMåjF]r#jdX$bindirr$…r%}r&(jKj!jLjubaubj)r'}r((jKUjQ}r)(jS]jT]jU]jV]jX]ujLjjF]r*j{)r+}r,(jKXmThe path variable that expands to the path given by the :option:`--bindir` configure option (or the default).jLj'jMjNjOj~jQ}r-(jS]jT]jU]jV]jX]ujZMåjF]r.(jdX8The path variable that expands to the path given by the r/…r0}r1(jKX8The path variable that expands to the path given by the jLj+ubj¯)r2}r3(jKX:option:`--bindir`r4jLj+jMjNjOj³jQ}r5(UreftypeXoptionjµˆj¶X--bindirU refdomainXstdr6jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMåjF]r7j„)r8}r9(jKj4jQ}r:(jS]jT]r;(jÀj6X std-optionr<ejU]jV]jX]ujLj2jF]r=jdX--bindirr>…r?}r@(jKUjLj8ubajOjŒubaubjdX# configure option (or the default).rA…rB}rC(jKX# configure option (or the default).jLj+ubeubajOjubeubjô)rD}rE(jKX+$libdir As above but for :option:`--libdir`jLjïjMjNjOj÷jQ}rF(jS]jT]jU]jV]jX]ujZMçj[hjF]rG(jú)rH}rI(jKX$libdirrJjLjDjMjNjOjþjQ}rK(jS]jT]jU]jV]jX]ujZMçjF]rLjdX$libdirrM…rN}rO(jKjJjLjHubaubj)rP}rQ(jKUjQ}rR(jS]jT]jU]jV]jX]ujLjDjF]rSj{)rT}rU(jKX#As above but for :option:`--libdir`jLjPjMjNjOj~jQ}rV(jS]jT]jU]jV]jX]ujZMèjF]rW(jdXAs above but for rX…rY}rZ(jKXAs above but for jLjTubj¯)r[}r\(jKX:option:`--libdir`r]jLjTjMjNjOj³jQ}r^(UreftypeXoptionjµˆj¶X--libdirU refdomainXstdr_jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMèjF]r`j„)ra}rb(jKj]jQ}rc(jS]jT]rd(jÀj_X std-optionreejU]jV]jX]ujLj[jF]rfjdX--libdirrg…rh}ri(jKUjLjaubajOjŒubaubeubajOjubeubjô)rj}rk(jKX1$libsubdir As above but for :option:`--libsubdir`jLjïjMjNjOj÷jQ}rl(jS]jT]jU]jV]jX]ujZMéj[hjF]rm(jú)rn}ro(jKX $libsubdirrpjLjjjMjNjOjþjQ}rq(jS]jT]jU]jV]jX]ujZMéjF]rrjdX $libsubdirrs…rt}ru(jKjpjLjnubaubj)rv}rw(jKUjQ}rx(jS]jT]jU]jV]jX]ujLjjjF]ryj{)rz}r{(jKX&As above but for :option:`--libsubdir`jLjvjMjNjOj~jQ}r|(jS]jT]jU]jV]jX]ujZMêjF]r}(jdXAs above but for r~…r}r€(jKXAs above but for jLjzubj¯)r}r‚(jKX:option:`--libsubdir`rƒjLjzjMjNjOj³jQ}r„(UreftypeXoptionjµˆj¶X --libsubdirU refdomainXstdr…jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMêjF]r†j„)r‡}rˆ(jKjƒjQ}r‰(jS]jT]rŠ(jÀj…X std-optionr‹ejU]jV]jX]ujLjjF]rŒjdX --libsubdirr…rŽ}r(jKUjLj‡ubajOjŒubaubeubajOjubeubjô)r}r‘(jKX1$dynlibdir As above but for :option:`--dynlibdir`jLjïjMjNjOj÷jQ}r’(jS]jT]jU]jV]jX]ujZMëj[hjF]r“(jú)r”}r•(jKX $dynlibdirr–jLjjMjNjOjþjQ}r—(jS]jT]jU]jV]jX]ujZMëjF]r˜jdX $dynlibdirr™…rš}r›(jKj–jLj”ubaubj)rœ}r(jKUjQ}rž(jS]jT]jU]jV]jX]ujLjjF]rŸj{)r }r¡(jKX&As above but for :option:`--dynlibdir`jLjœjMjNjOj~jQ}r¢(jS]jT]jU]jV]jX]ujZMìjF]r£(jdXAs above but for r¤…r¥}r¦(jKXAs above but for jLj ubj¯)r§}r¨(jKX:option:`--dynlibdir`r©jLj jMjNjOj³jQ}rª(UreftypeXoptionjµˆj¶X --dynlibdirU refdomainXstdr«jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMìjF]r¬j„)r­}r®(jKj©jQ}r¯(jS]jT]r°(jÀj«X std-optionr±ejU]jV]jX]ujLj§jF]r²jdX --dynlibdirr³…r´}rµ(jKUjLj­ubajOjŒubaubeubajOjubeubjô)r¶}r·(jKX-$datadir As above but for :option:`--datadir`jLjïjMjNjOj÷jQ}r¸(jS]jT]jU]jV]jX]ujZMíj[hjF]r¹(jú)rº}r»(jKX$datadirr¼jLj¶jMjNjOjþjQ}r½(jS]jT]jU]jV]jX]ujZMíjF]r¾jdX$datadirr¿…rÀ}rÁ(jKj¼jLjºubaubj)rÂ}rÃ(jKUjQ}rÄ(jS]jT]jU]jV]jX]ujLj¶jF]rÅj{)rÆ}rÇ(jKX$As above but for :option:`--datadir`jLjÂjMjNjOj~jQ}rÈ(jS]jT]jU]jV]jX]ujZMîjF]rÉ(jdXAs above but for rÊ…rË}rÌ(jKXAs above but for jLjÆubj¯)rÍ}rÎ(jKX:option:`--datadir`rÏjLjÆjMjNjOj³jQ}rÐ(UreftypeXoptionjµˆj¶X --datadirU refdomainXstdrÑjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMîjF]rÒj„)rÓ}rÔ(jKjÏjQ}rÕ(jS]jT]rÖ(jÀjÑX std-optionr×ejU]jV]jX]ujLjÍjF]rØjdX --datadirrÙ…rÚ}rÛ(jKUjLjÓubajOjŒubaubeubajOjubeubjô)rÜ}rÝ(jKX3$datasubdir As above but for :option:`--datasubdir`jLjïjMjNjOj÷jQ}rÞ(jS]jT]jU]jV]jX]ujZMïj[hjF]rß(jú)rà}rá(jKX $datasubdirrâjLjÜjMjNjOjþjQ}rã(jS]jT]jU]jV]jX]ujZMïjF]räjdX $datasubdirrå…ræ}rç(jKjâjLjàubaubj)rè}ré(jKUjQ}rê(jS]jT]jU]jV]jX]ujLjÜjF]rëj{)rì}rí(jKX'As above but for :option:`--datasubdir`jLjèjMjNjOj~jQ}rî(jS]jT]jU]jV]jX]ujZMðjF]rï(jdXAs above but for rð…rñ}rò(jKXAs above but for jLjìubj¯)ró}rô(jKX:option:`--datasubdir`rõjLjìjMjNjOj³jQ}rö(UreftypeXoptionjµˆj¶X --datasubdirU refdomainXstdr÷jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMðjF]røj„)rù}rú(jKjõjQ}rû(jS]jT]rü(jÀj÷X std-optionrýejU]jV]jX]ujLjójF]rþjdX --datasubdirrÿ…r}r(jKUjLjùubajOjŒubaubeubajOjubeubjô)r}r(jKX+$docdir As above but for :option:`--docdir`jLjïjMjNjOj÷jQ}r(jS]jT]jU]jV]jX]ujZMñj[hjF]r(jú)r}r(jKX$docdirrjLjjMjNjOjþjQ}r (jS]jT]jU]jV]jX]ujZMñjF]r jdX$docdirr …r }r (jKjjLjubaubj)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjjF]rj{)r}r(jKX#As above but for :option:`--docdir`jLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMòjF]r(jdXAs above but for r…r}r(jKXAs above but for jLjubj¯)r}r(jKX:option:`--docdir`rjLjjMjNjOj³jQ}r(UreftypeXoptionjµˆj¶X--docdirU refdomainXstdrjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMòjF]rj„)r}r (jKjjQ}r!(jS]jT]r"(jÀjX std-optionr#ejU]jV]jX]ujLjjF]r$jdX--docdirr%…r&}r'(jKUjLjubajOjŒubaubeubajOjubeubjô)r(}r)(jKX>$pkgid The name and version of the package, e.g. ``mypkg-0.2``jLjïjMjNjOj÷jQ}r*(jS]jT]jU]jV]jX]ujZMój[hjF]r+(jú)r,}r-(jKX$pkgidr.jLj(jMjNjOjþjQ}r/(jS]jT]jU]jV]jX]ujZMójF]r0jdX$pkgidr1…r2}r3(jKj.jLj,ubaubj)r4}r5(jKUjQ}r6(jS]jT]jU]jV]jX]ujLj(jF]r7j{)r8}r9(jKX7The name and version of the package, e.g. ``mypkg-0.2``jLj4jMjNjOj~jQ}r:(jS]jT]jU]jV]jX]ujZMôjF]r;(jdX*The name and version of the package, e.g. r<…r=}r>(jKX*The name and version of the package, e.g. jLj8ubj„)r?}r@(jKX ``mypkg-0.2``jQ}rA(jS]jT]jU]jV]jX]ujLj8jF]rBjdX mypkg-0.2rC…rD}rE(jKUjLj?ubajOjŒubeubajOjubeubjô)rF}rG(jKX,$pkg The name of the package, e.g. ``mypkg``jLjïjMjNjOj÷jQ}rH(jS]jT]jU]jV]jX]ujZMõj[hjF]rI(jú)rJ}rK(jKX$pkgrLjLjFjMjNjOjþjQ}rM(jS]jT]jU]jV]jX]ujZMõjF]rNjdX$pkgrO…rP}rQ(jKjLjLjJubaubj)rR}rS(jKUjQ}rT(jS]jT]jU]jV]jX]ujLjFjF]rUj{)rV}rW(jKX'The name of the package, e.g. ``mypkg``jLjRjMjNjOj~jQ}rX(jS]jT]jU]jV]jX]ujZMöjF]rY(jdXThe name of the package, e.g. rZ…r[}r\(jKXThe name of the package, e.g. jLjVubj„)r]}r^(jKX ``mypkg``jQ}r_(jS]jT]jU]jV]jX]ujLjVjF]r`jdXmypkgra…rb}rc(jKUjLj]ubajOjŒubeubajOjubeubjô)rd}re(jKX1$version The version of the package, e.g. ``0.2``jLjïjMjNjOj÷jQ}rf(jS]jT]jU]jV]jX]ujZM÷j[hjF]rg(jú)rh}ri(jKX$versionrjjLjdjMjNjOjþjQ}rk(jS]jT]jU]jV]jX]ujZM÷jF]rljdX$versionrm…rn}ro(jKjjjLjhubaubj)rp}rq(jKUjQ}rr(jS]jT]jU]jV]jX]ujLjdjF]rsj{)rt}ru(jKX(The version of the package, e.g. ``0.2``jLjpjMjNjOj~jQ}rv(jS]jT]jU]jV]jX]ujZMøjF]rw(jdX!The version of the package, e.g. rx…ry}rz(jKX!The version of the package, e.g. jLjtubj„)r{}r|(jKX``0.2``jQ}r}(jS]jT]jU]jV]jX]ujLjtjF]r~jdX0.2r…r€}r(jKUjLj{ubajOjŒubeubajOjubeubjô)r‚}rƒ(jKXJ$compiler The compiler being used to build the package, e.g. ``ghc-6.6.1``jLjïjMjNjOj÷jQ}r„(jS]jT]jU]jV]jX]ujZMùj[hjF]r…(jú)r†}r‡(jKX $compilerrˆjLj‚jMjNjOjþjQ}r‰(jS]jT]jU]jV]jX]ujZMùjF]rŠjdX $compilerr‹…rŒ}r(jKjˆjLj†ubaubj)rŽ}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLj‚jF]r‘j{)r’}r“(jKX@The compiler being used to build the package, e.g. ``ghc-6.6.1``jLjŽjMjNjOj~jQ}r”(jS]jT]jU]jV]jX]ujZMújF]r•(jdX3The compiler being used to build the package, e.g. r–…r—}r˜(jKX3The compiler being used to build the package, e.g. jLj’ubj„)r™}rš(jKX ``ghc-6.6.1``jQ}r›(jS]jT]jU]jV]jX]ujLj’jF]rœjdX ghc-6.6.1r…rž}rŸ(jKUjLj™ubajOjŒubeubajOjubeubjô)r }r¡(jKXŠ$os The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jLjïjMjNjOj÷jQ}r¢(jS]jT]jU]jV]jX]ujZMýj[hjF]r£(jú)r¤}r¥(jKX$osr¦jLj jMjNjOjþjQ}r§(jS]jT]jU]jV]jX]ujZMýjF]r¨jdX$osr©…rª}r«(jKj¦jLj¤ubaubj)r¬}r­(jKUjQ}r®(jS]jT]jU]jV]jX]ujLj jF]r¯j{)r°}r±(jKX†The operating system of the computer being used to build the package, e.g. ``linux``, ``windows``, ``osx``, ``freebsd`` or ``solaris``jLj¬jMjNjOj~jQ}r²(jS]jT]jU]jV]jX]ujZMüjF]r³(jdXKThe operating system of the computer being used to build the package, e.g. r´…rµ}r¶(jKXKThe operating system of the computer being used to build the package, e.g. jLj°ubj„)r·}r¸(jKX ``linux``jQ}r¹(jS]jT]jU]jV]jX]ujLj°jF]rºjdXlinuxr»…r¼}r½(jKUjLj·ubajOjŒubjdX, r¾…r¿}rÀ(jKX, rÁjLj°ubj„)rÂ}rÃ(jKX ``windows``jQ}rÄ(jS]jT]jU]jV]jX]ujLj°jF]rÅjdXwindowsrÆ…rÇ}rÈ(jKUjLjÂubajOjŒubjdX, rÉ…rÊ}rË(jKX, jLj°ubj„)rÌ}rÍ(jKX``osx``jQ}rÎ(jS]jT]jU]jV]jX]ujLj°jF]rÏjdXosxrÐ…rÑ}rÒ(jKUjLjÌubajOjŒubjdX, rÓ…rÔ}rÕ(jKjÁjLj°ubj„)rÖ}r×(jKX ``freebsd``jQ}rØ(jS]jT]jU]jV]jX]ujLj°jF]rÙjdXfreebsdrÚ…rÛ}rÜ(jKUjLjÖubajOjŒubjdX or rÝ…rÞ}rß(jKX or jLj°ubj„)rà}rá(jKX ``solaris``jQ}râ(jS]jT]jU]jV]jX]ujLj°jF]rãjdXsolarisrä…rå}ræ(jKUjLjàubajOjŒubeubajOjubeubjô)rç}rè(jKXw$arch The architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jLjïjMjNjOj÷jQ}ré(jS]jT]jU]jV]jX]ujZMj[hjF]rê(jú)rë}rì(jKX$archríjLjçjMjNjOjþjQ}rî(jS]jT]jU]jV]jX]ujZMjF]rïjdX$archrð…rñ}rò(jKjíjLjëubaubj)ró}rô(jKUjQ}rõ(jS]jT]jU]jV]jX]ujLjçjF]röj{)r÷}rø(jKXqThe architecture of the computer being used to build the package, e.g. ``i386``, ``x86_64``, ``ppc`` or ``sparc``jLjójMjNjOj~jQ}rù(jS]jT]jU]jV]jX]ujZMjF]rú(jdXGThe architecture of the computer being used to build the package, e.g. rû…rü}rý(jKXGThe architecture of the computer being used to build the package, e.g. jLj÷ubj„)rþ}rÿ(jKX``i386``jQ}r(jS]jT]jU]jV]jX]ujLj÷jF]rjdXi386r…r}r(jKUjLjþubajOjŒubjdX, r…r}r(jKX, rjLj÷ubj„)r }r (jKX ``x86_64``jQ}r (jS]jT]jU]jV]jX]ujLj÷jF]r jdXx86_64r …r}r(jKUjLj ubajOjŒubjdX, r…r}r(jKjjLj÷ubj„)r}r(jKX``ppc``jQ}r(jS]jT]jU]jV]jX]ujLj÷jF]rjdXppcr…r}r(jKUjLjubajOjŒubjdX or r…r}r(jKX or jLj÷ubj„)r}r(jKX ``sparc``jQ}r(jS]jT]jU]jV]jX]ujLj÷jF]r jdXsparcr!…r"}r#(jKUjLjubajOjŒubeubajOjubeubjô)r$}r%(jKX§$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.jLjïjMjNjOj÷jQ}r&(jS]jT]jU]jV]jX]ujZMj[hjF]r'(jú)r(}r)(jKX$abitagr*jLj$jMjNjOjþjQ}r+(jS]jT]jU]jV]jX]ujZMjF]r,jdX$abitagr-…r.}r/(jKj*jLj(ubaubj)r0}r1(jKUjQ}r2(jS]jT]jU]jV]jX]ujLj$jF]r3j{)r4}r5(jKXŸ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.r6jLj0jMjNjOj~jQ}r7(jS]jT]jU]jV]jX]ujZMjF]r8jdX¡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.r9…r:}r;(jKj6jLj4ubaubajOjubeubjô)r<}r=(jKXñ$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. jLjïjMjNjOj÷jQ}r>(jS]jT]jU]jV]jX]ujZM j[hjF]r?(jú)r@}rA(jKX$abirBjLj<jMjNjOjþjQ}rC(jS]jT]jU]jV]jX]ujZM jF]rDjdX$abirE…rF}rG(jKjBjLj@ubaubj)rH}rI(jKUjQ}rJ(jS]jT]jU]jV]jX]ujLj<jF]rKj{)rL}rM(jKXë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.jLjHjMjNjOj~jQ}rN(jS]jT]jU]jV]jX]ujZMjF]rO(jdX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as rP…rQ}rR(jKX…A shortcut for getting a path that completely identifies the platform in terms of binary compatibility. Expands to the same value as jLjLubj„)rS}rT(jKX``$arch-$os-compiler-$abitag``jQ}rU(jS]jT]jU]jV]jX]ujLjLjF]rVjdX$arch-$os-compiler-$abitagrW…rX}rY(jKUjLjSubajOjŒubjdX" if the compiler uses an abi tag, rZ…r[}r\(jKX" if the compiler uses an abi tag, jLjLubj„)r]}r^(jKX``$arch-$os-$compiler``jQ}r_(jS]jT]jU]jV]jX]ujLjLjF]r`jdX$arch-$os-$compilerra…rb}rc(jKUjLj]ubajOjŒubjdX if it doesn’t.rd…re}rf(jKX if it doesn't.jLjLubeubajOjubeubeubeubjH)rg}rh(jKUjLj jMjNjOjPjQ}ri(jS]jT]jU]jV]rjhêajX]rkhCaujZM j[hjF]rl(j])rm}rn(jKX Paths in the simple build systemrojLjgjMjNjOjajQ}rp(jS]jT]jU]jV]jX]ujZM j[hjF]rqjdX Paths in the simple build systemrr…rs}rt(jKjojMNjZNj[hjLjmubaubj{)ru}rv(jKX:For the simple build system, the following defaults apply:rwjLjgjMjNjOj~jQ}rx(jS]jT]jU]jV]jX]ujZMj[hjF]ryjdX:For the simple build system, the following defaults apply:rz…r{}r|(jKjwjMNjZNj[hjLjuubaubcdocutils.nodes table r})r~}r(jKUjLjgjMNjOUtabler€jQ}r(jS]jT]jU]jV]r‚Uid11rƒajX]ujZNj[hjF]r„(j])r…}r†(jKXDefault installation pathsr‡jLj~jMjNjOjajQ}rˆ(jS]jT]jU]jV]jX]ujZMjF]r‰jdXDefault installation pathsrŠ…r‹}rŒ(jKj‡jLj…ubaubcdocutils.nodes tgroup r)rŽ}r(jKUjQ}r(jV]jU]jS]jT]jX]UcolsKujLj~jF]r‘(cdocutils.nodes colspec r’)r“}r”(jKUjQ}r•(jV]jU]jS]jT]jX]Ucolwidthr–K!ujLjŽjF]jOUcolspecr—ubj’)r˜}r™(jKUjQ}rš(jV]jU]jS]jT]jX]j–K!ujLjŽjF]jOj—ubj’)r›}rœ(jKUjQ}r(jV]jU]jS]jT]jX]j–K!ujLjŽjF]jOj—ubcdocutils.nodes tbody rž)rŸ}r (jKUjQ}r¡(jS]jT]jU]jV]jX]ujLjŽjF]r¢(cdocutils.nodes row r£)r¤}r¥(jKUjQ}r¦(jS]jT]jU]jV]jX]ujLjŸjF]r§(cdocutils.nodes entry r¨)r©}rª(jKUjQ}r«(jS]jT]jU]jV]jX]ujLj¤jF]r¬j{)r­}r®(jKXOptionr¯jLj©jMjNjOj~jQ}r°(jS]jT]jU]jV]jX]ujZMjF]r±jdXOptionr²…r³}r´(jKj¯jLj­ubaubajOUentryrµubj¨)r¶}r·(jKUjQ}r¸(jS]jT]jU]jV]jX]ujLj¤jF]r¹j{)rº}r»(jKX Unix Defaultr¼jLj¶jMjNjOj~jQ}r½(jS]jT]jU]jV]jX]ujZMjF]r¾jdX Unix Defaultr¿…rÀ}rÁ(jKj¼jLjºubaubajOjµubj¨)rÂ}rÃ(jKUjQ}rÄ(jS]jT]jU]jV]jX]ujLj¤jF]rÅj{)rÆ}rÇ(jKXWindows DefaultrÈjLjÂjMjNjOj~jQ}rÉ(jS]jT]jU]jV]jX]ujZMjF]rÊjdXWindows DefaultrË…rÌ}rÍ(jKjÈjLjÆubaubajOjµubejOUrowrÎubj£)rÏ}rÐ(jKUjQ}rÑ(jS]jT]jU]jV]jX]ujLjŸjF]rÒ(j¨)rÓ}rÔ(jKUjQ}rÕ(jS]jT]jU]jV]jX]ujLjÏjF]rÖj{)r×}rØ(jKX:option:`--prefix` (global)rÙjLjÓjMjNjOj~jQ}rÚ(jS]jT]jU]jV]jX]ujZMjF]rÛ(j¯)rÜ}rÝ(jKX:option:`--prefix`rÞjLj×jMjNjOj³jQ}rß(UreftypeXoptionjµˆj¶X--prefixU refdomainXstdràjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]ráj„)râ}rã(jKjÞjQ}rä(jS]jT]rå(jÀjàX std-optionræejU]jV]jX]ujLjÜjF]rçjdX--prefixrè…ré}rê(jKUjLjâubajOjŒubaubjdX (global)rë…rì}rí(jKX (global)jLj×ubeubajOjµubj¨)rî}rï(jKUjQ}rð(jS]jT]jU]jV]jX]ujLjÏjF]rñj{)rò}ró(jKX``/usr/local``rôjLjîjMjNjOj~jQ}rõ(jS]jT]jU]jV]jX]ujZMjF]röj„)r÷}rø(jKjôjQ}rù(jS]jT]jU]jV]jX]ujLjòjF]rújdX /usr/localrû…rü}rý(jKUjLj÷ubajOjŒubaubajOjµubj¨)rþ}rÿ(jKUjQ}r(jS]jT]jU]jV]jX]ujLjÏjF]rj{)r}r(jKX``%PROGRAMFILES%\Haskell``rjLjþjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMjF]rj„)r}r(jKX``%PROGRAMFILES%\Haskell``jQ}r (jS]jT]jU]jV]jX]ujLjjF]r jdX%PROGRAMFILES%\Haskellr …r }r (jKUjLjubajOjŒubaubajOjµubejOjÎubj£)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjŸjF]r(j¨)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjjF]rj{)r}r(jKX:option:`--prefix` (per-user)rjLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMjF]r(j¯)r}r(jKX:option:`--prefix`rjLjjMjNjOj³jQ}r(UreftypeXoptionjµˆj¶X--prefixU refdomainXstdrjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]r j„)r!}r"(jKjjQ}r#(jS]jT]r$(jÀjX std-optionr%ejU]jV]jX]ujLjjF]r&jdX--prefixr'…r(}r)(jKUjLj!ubajOjŒubaubjdX (per-user)r*…r+}r,(jKX (per-user)jLjubeubajOjµubj¨)r-}r.(jKUjQ}r/(jS]jT]jU]jV]jX]ujLjjF]r0j{)r1}r2(jKX``$HOME/.cabal``r3jLj-jMjNjOj~jQ}r4(jS]jT]jU]jV]jX]ujZMjF]r5j„)r6}r7(jKj3jQ}r8(jS]jT]jU]jV]jX]ujLj1jF]r9jdX $HOME/.cabalr:…r;}r<(jKUjLj6ubajOjŒubaubajOjµubj¨)r=}r>(jKUjQ}r?(jS]jT]jU]jV]jX]ujLjjF]r@j{)rA}rB(jKX``%APPDATA%\cabal``rCjLj=jMjNjOj~jQ}rD(jS]jT]jU]jV]jX]ujZMjF]rEj„)rF}rG(jKX``%APPDATA%\cabal``jQ}rH(jS]jT]jU]jV]jX]ujLjAjF]rIjdX%APPDATA%\cabalrJ…rK}rL(jKUjLjFubajOjŒubaubajOjµubejOjÎubj£)rM}rN(jKUjQ}rO(jS]jT]jU]jV]jX]ujLjŸjF]rP(j¨)rQ}rR(jKUjQ}rS(jS]jT]jU]jV]jX]ujLjMjF]rTj{)rU}rV(jKX:option:`--bindir`rWjLjQjMjNjOj~jQ}rX(jS]jT]jU]jV]jX]ujZMjF]rYj¯)rZ}r[(jKjWjLjUjMjNjOj³jQ}r\(UreftypeXoptionjµˆj¶X--bindirU refdomainXstdr]jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]r^j„)r_}r`(jKjWjQ}ra(jS]jT]rb(jÀj]X std-optionrcejU]jV]jX]ujLjZjF]rdjdX--bindirre…rf}rg(jKUjLj_ubajOjŒubaubaubajOjµubj¨)rh}ri(jKUjQ}rj(jS]jT]jU]jV]jX]ujLjMjF]rkj{)rl}rm(jKX``$prefix/bin``rnjLjhjMjNjOj~jQ}ro(jS]jT]jU]jV]jX]ujZMjF]rpj„)rq}rr(jKjnjQ}rs(jS]jT]jU]jV]jX]ujLjljF]rtjdX $prefix/binru…rv}rw(jKUjLjqubajOjŒubaubajOjµubj¨)rx}ry(jKUjQ}rz(jS]jT]jU]jV]jX]ujLjMjF]r{j{)r|}r}(jKX``$prefix\bin``r~jLjxjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMjF]r€j„)r}r‚(jKX``$prefix\bin``jQ}rƒ(jS]jT]jU]jV]jX]ujLj|jF]r„jdX $prefix\binr……r†}r‡(jKUjLjubajOjŒubaubajOjµubejOjÎubj£)rˆ}r‰(jKUjQ}rŠ(jS]jT]jU]jV]jX]ujLjŸjF]r‹(j¨)rŒ}r(jKUjQ}rŽ(jS]jT]jU]jV]jX]ujLjˆjF]rj{)r}r‘(jKX:option:`--libdir`r’jLjŒjMjNjOj~jQ}r“(jS]jT]jU]jV]jX]ujZMjF]r”j¯)r•}r–(jKj’jLjjMjNjOj³jQ}r—(UreftypeXoptionjµˆj¶X--libdirU refdomainXstdr˜jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]r™j„)rš}r›(jKj’jQ}rœ(jS]jT]r(jÀj˜X std-optionržejU]jV]jX]ujLj•jF]rŸjdX--libdirr …r¡}r¢(jKUjLjšubajOjŒubaubaubajOjµubj¨)r£}r¤(jKUjQ}r¥(jS]jT]jU]jV]jX]ujLjˆjF]r¦j{)r§}r¨(jKX``$prefix/lib``r©jLj£jMjNjOj~jQ}rª(jS]jT]jU]jV]jX]ujZM jF]r«j„)r¬}r­(jKj©jQ}r®(jS]jT]jU]jV]jX]ujLj§jF]r¯jdX $prefix/libr°…r±}r²(jKUjLj¬ubajOjŒubaubajOjµubj¨)r³}r´(jKUjQ}rµ(jS]jT]jU]jV]jX]ujLjˆjF]r¶j{)r·}r¸(jKX ``$prefix``r¹jLj³jMjNjOj~jQ}rº(jS]jT]jU]jV]jX]ujZM!jF]r»j„)r¼}r½(jKj¹jQ}r¾(jS]jT]jU]jV]jX]ujLj·jF]r¿jdX$prefixrÀ…rÁ}rÂ(jKUjLj¼ubajOjŒubaubajOjµubejOjÎubj£)rÃ}rÄ(jKUjQ}rÅ(jS]jT]jU]jV]jX]ujLjŸjF]rÆ(j¨)rÇ}rÈ(jKUjQ}rÉ(jS]jT]jU]jV]jX]ujLjÃjF]rÊj{)rË}rÌ(jKX:option:`--libsubdir` (others)rÍjLjÇjMjNjOj~jQ}rÎ(jS]jT]jU]jV]jX]ujZM"jF]rÏ(j¯)rÐ}rÑ(jKX:option:`--libsubdir`rÒjLjËjMjNjOj³jQ}rÓ(UreftypeXoptionjµˆj¶X --libsubdirU refdomainXstdrÔjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM"jF]rÕj„)rÖ}r×(jKjÒjQ}rØ(jS]jT]rÙ(jÀjÔX std-optionrÚejU]jV]jX]ujLjÐjF]rÛjdX --libsubdirrÜ…rÝ}rÞ(jKUjLjÖubajOjŒubaubjdX (others)rß…rà}rá(jKX (others)jLjËubeubajOjµubj¨)râ}rã(jKUjQ}rä(jS]jT]jU]jV]jX]ujLjÃjF]råj{)ræ}rç(jKX``$pkgid/$compiler``rèjLjâjMjNjOj~jQ}ré(jS]jT]jU]jV]jX]ujZM#jF]rêj„)rë}rì(jKjèjQ}rí(jS]jT]jU]jV]jX]ujLjæjF]rîjdX$pkgid/$compilerrï…rð}rñ(jKUjLjëubajOjŒubaubajOjµubj¨)rò}ró(jKUjQ}rô(jS]jT]jU]jV]jX]ujLjÃjF]rõj{)rö}r÷(jKX``$pkgid\$compiler``røjLjòjMjNjOj~jQ}rù(jS]jT]jU]jV]jX]ujZM$jF]rúj„)rû}rü(jKX``$pkgid\$compiler``jQ}rý(jS]jT]jU]jV]jX]ujLjöjF]rþjdX$pkgid\$compilerrÿ…r}r(jKUjLjûubajOjŒubaubajOjµubejOjÎubj£)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjŸjF]r(j¨)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjjF]r j{)r }r (jKX:option:`--dynlibdir`r jLjjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZM%jF]rj¯)r}r(jKj jLj jMjNjOj³jQ}r(UreftypeXoptionjµˆj¶X --dynlibdirU refdomainXstdrjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM%jF]rj„)r}r(jKj jQ}r(jS]jT]r(jÀjX std-optionrejU]jV]jX]ujLjjF]rjdX --dynlibdirr…r}r(jKUjLjubajOjŒubaubaubajOjµubj¨)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjjF]r j{)r!}r"(jKX``$libdir/$abi``r#jLjjMjNjOj~jQ}r$(jS]jT]jU]jV]jX]ujZM&jF]r%j„)r&}r'(jKj#jQ}r((jS]jT]jU]jV]jX]ujLj!jF]r)jdX $libdir/$abir*…r+}r,(jKUjLj&ubajOjŒubaubajOjµubj¨)r-}r.(jKUjQ}r/(jS]jT]jU]jV]jX]ujLjjF]r0j{)r1}r2(jKX``$libdir\$abi``r3jLj-jMjNjOj~jQ}r4(jS]jT]jU]jV]jX]ujZM'jF]r5j„)r6}r7(jKX``$libdir\$abi``jQ}r8(jS]jT]jU]jV]jX]ujLj1jF]r9jdX $libdir\$abir:…r;}r<(jKUjLj6ubajOjŒubaubajOjµubejOjÎubj£)r=}r>(jKUjQ}r?(jS]jT]jU]jV]jX]ujLjŸjF]r@(j¨)rA}rB(jKUjQ}rC(jS]jT]jU]jV]jX]ujLj=jF]rDj{)rE}rF(jKX:option:`--libexecdir`rGjLjAjMjNjOj~jQ}rH(jS]jT]jU]jV]jX]ujZM(jF]rIj¯)rJ}rK(jKjGjLjEjMjNjOj³jQ}rL(UreftypeXoptionjµˆj¶X --libexecdirU refdomainXstdrMjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM(jF]rNj„)rO}rP(jKjGjQ}rQ(jS]jT]rR(jÀjMX std-optionrSejU]jV]jX]ujLjJjF]rTjdX --libexecdirrU…rV}rW(jKUjLjOubajOjŒubaubaubajOjµubj¨)rX}rY(jKUjQ}rZ(jS]jT]jU]jV]jX]ujLj=jF]r[j{)r\}r](jKX``$prefix/libexec``r^jLjXjMjNjOj~jQ}r_(jS]jT]jU]jV]jX]ujZM)jF]r`j„)ra}rb(jKj^jQ}rc(jS]jT]jU]jV]jX]ujLj\jF]rdjdX$prefix/libexecre…rf}rg(jKUjLjaubajOjŒubaubajOjµubj¨)rh}ri(jKUjQ}rj(jS]jT]jU]jV]jX]ujLj=jF]rkj{)rl}rm(jKX``$prefix\$pkgid``rnjLjhjMjNjOj~jQ}ro(jS]jT]jU]jV]jX]ujZM*jF]rpj„)rq}rr(jKX``$prefix\$pkgid``jQ}rs(jS]jT]jU]jV]jX]ujLjljF]rtjdX$prefix\$pkgidru…rv}rw(jKUjLjqubajOjŒubaubajOjµubejOjÎubj£)rx}ry(jKUjQ}rz(jS]jT]jU]jV]jX]ujLjŸjF]r{(j¨)r|}r}(jKUjQ}r~(jS]jT]jU]jV]jX]ujLjxjF]rj{)r€}r(jKX :option:`--datadir` (executable)r‚jLj|jMjNjOj~jQ}rƒ(jS]jT]jU]jV]jX]ujZM+jF]r„(j¯)r…}r†(jKX:option:`--datadir`r‡jLj€jMjNjOj³jQ}rˆ(UreftypeXoptionjµˆj¶X --datadirU refdomainXstdr‰jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM+jF]rŠj„)r‹}rŒ(jKj‡jQ}r(jS]jT]rŽ(jÀj‰X std-optionrejU]jV]jX]ujLj…jF]rjdX --datadirr‘…r’}r“(jKUjLj‹ubajOjŒubaubjdX (executable)r”…r•}r–(jKX (executable)jLj€ubeubajOjµubj¨)r—}r˜(jKUjQ}r™(jS]jT]jU]jV]jX]ujLjxjF]ršj{)r›}rœ(jKX``$prefix/share``rjLj—jMjNjOj~jQ}rž(jS]jT]jU]jV]jX]ujZM,jF]rŸj„)r }r¡(jKjjQ}r¢(jS]jT]jU]jV]jX]ujLj›jF]r£jdX $prefix/sharer¤…r¥}r¦(jKUjLj ubajOjŒubaubajOjµubj¨)r§}r¨(jKUjQ}r©(jS]jT]jU]jV]jX]ujLjxjF]rªj{)r«}r¬(jKX ``$prefix``r­jLj§jMjNjOj~jQ}r®(jS]jT]jU]jV]jX]ujZM-jF]r¯j„)r°}r±(jKj­jQ}r²(jS]jT]jU]jV]jX]ujLj«jF]r³jdX$prefixr´…rµ}r¶(jKUjLj°ubajOjŒubaubajOjµubejOjÎubj£)r·}r¸(jKUjQ}r¹(jS]jT]jU]jV]jX]ujLjŸjF]rº(j¨)r»}r¼(jKUjQ}r½(jS]jT]jU]jV]jX]ujLj·jF]r¾j{)r¿}rÀ(jKX:option:`--datadir` (library)rÁjLj»jMjNjOj~jQ}rÂ(jS]jT]jU]jV]jX]ujZM.jF]rÃ(j¯)rÄ}rÅ(jKX:option:`--datadir`rÆjLj¿jMjNjOj³jQ}rÇ(UreftypeXoptionjµˆj¶X --datadirU refdomainXstdrÈjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM.jF]rÉj„)rÊ}rË(jKjÆjQ}rÌ(jS]jT]rÍ(jÀjÈX std-optionrÎejU]jV]jX]ujLjÄjF]rÏjdX --datadirrÐ…rÑ}rÒ(jKUjLjÊubajOjŒubaubjdX (library)rÓ…rÔ}rÕ(jKX (library)jLj¿ubeubajOjµubj¨)rÖ}r×(jKUjQ}rØ(jS]jT]jU]jV]jX]ujLj·jF]rÙj{)rÚ}rÛ(jKX``$prefix/share``rÜjLjÖjMjNjOj~jQ}rÝ(jS]jT]jU]jV]jX]ujZM/jF]rÞj„)rß}rà(jKjÜjQ}rá(jS]jT]jU]jV]jX]ujLjÚjF]râjdX $prefix/sharerã…rä}rå(jKUjLjßubajOjŒubaubajOjµubj¨)ræ}rç(jKUjQ}rè(jS]jT]jU]jV]jX]ujLj·jF]réj{)rê}rë(jKX``%PROGRAMFILES%\Haskell``rìjLjæjMjNjOj~jQ}rí(jS]jT]jU]jV]jX]ujZM0jF]rîj„)rï}rð(jKX``%PROGRAMFILES%\Haskell``jQ}rñ(jS]jT]jU]jV]jX]ujLjêjF]ròjdX%PROGRAMFILES%\Haskellró…rô}rõ(jKUjLjïubajOjŒubaubajOjµubejOjÎubj£)rö}r÷(jKUjQ}rø(jS]jT]jU]jV]jX]ujLjŸjF]rù(j¨)rú}rû(jKUjQ}rü(jS]jT]jU]jV]jX]ujLjöjF]rýj{)rþ}rÿ(jKX:option:`--datasubdir`rjLjújMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM1jF]rj¯)r}r(jKjjLjþjMjNjOj³jQ}r(UreftypeXoptionjµˆj¶X --datasubdirU refdomainXstdrjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM1jF]rj„)r}r (jKjjQ}r (jS]jT]r (jÀjX std-optionr ejU]jV]jX]ujLjjF]r jdX --datasubdirr…r}r(jKUjLjubajOjŒubaubaubajOjµubj¨)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjöjF]rj{)r}r(jKX ``$pkgid``rjLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM2jF]rj„)r}r(jKjjQ}r(jS]jT]jU]jV]jX]ujLjjF]rjdX$pkgidr…r}r (jKUjLjubajOjŒubaubajOjµubj¨)r!}r"(jKUjQ}r#(jS]jT]jU]jV]jX]ujLjöjF]r$j{)r%}r&(jKX ``$pkgid``r'jLj!jMjNjOj~jQ}r((jS]jT]jU]jV]jX]ujZM3jF]r)j„)r*}r+(jKj'jQ}r,(jS]jT]jU]jV]jX]ujLj%jF]r-jdX$pkgidr.…r/}r0(jKUjLj*ubajOjŒubaubajOjµubejOjÎubj£)r1}r2(jKUjQ}r3(jS]jT]jU]jV]jX]ujLjŸjF]r4(j¨)r5}r6(jKUjQ}r7(jS]jT]jU]jV]jX]ujLj1jF]r8j{)r9}r:(jKX:option:`--docdir`r;jLj5jMjNjOj~jQ}r<(jS]jT]jU]jV]jX]ujZM4jF]r=j¯)r>}r?(jKj;jLj9jMjNjOj³jQ}r@(UreftypeXoptionjµˆj¶X--docdirU refdomainXstdrAjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM4jF]rBj„)rC}rD(jKj;jQ}rE(jS]jT]rF(jÀjAX std-optionrGejU]jV]jX]ujLj>jF]rHjdX--docdirrI…rJ}rK(jKUjLjCubajOjŒubaubaubajOjµubj¨)rL}rM(jKUjQ}rN(jS]jT]jU]jV]jX]ujLj1jF]rOj{)rP}rQ(jKX``$datadir/doc/$pkgid``rRjLjLjMjNjOj~jQ}rS(jS]jT]jU]jV]jX]ujZM5jF]rTj„)rU}rV(jKjRjQ}rW(jS]jT]jU]jV]jX]ujLjPjF]rXjdX$datadir/doc/$pkgidrY…rZ}r[(jKUjLjUubajOjŒubaubajOjµubj¨)r\}r](jKUjQ}r^(jS]jT]jU]jV]jX]ujLj1jF]r_j{)r`}ra(jKX``$prefix\doc\$pkgid``rbjLj\jMjNjOj~jQ}rc(jS]jT]jU]jV]jX]ujZM6jF]rdj„)re}rf(jKX``$prefix\doc\$pkgid``jQ}rg(jS]jT]jU]jV]jX]ujLj`jF]rhjdX$prefix\doc\$pkgidri…rj}rk(jKUjLjeubajOjŒubaubajOjµubejOjÎubj£)rl}rm(jKUjQ}rn(jS]jT]jU]jV]jX]ujLjŸjF]ro(j¨)rp}rq(jKUjQ}rr(jS]jT]jU]jV]jX]ujLjljF]rsj{)rt}ru(jKX:option:`--sysconfdir`rvjLjpjMjNjOj~jQ}rw(jS]jT]jU]jV]jX]ujZM7jF]rxj¯)ry}rz(jKjvjLjtjMjNjOj³jQ}r{(UreftypeXoptionjµˆj¶X --sysconfdirU refdomainXstdr|jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM7jF]r}j„)r~}r(jKjvjQ}r€(jS]jT]r(jÀj|X std-optionr‚ejU]jV]jX]ujLjyjF]rƒjdX --sysconfdirr„…r…}r†(jKUjLj~ubajOjŒubaubaubajOjµubj¨)r‡}rˆ(jKUjQ}r‰(jS]jT]jU]jV]jX]ujLjljF]rŠj{)r‹}rŒ(jKX``$prefix/etc``rjLj‡jMjNjOj~jQ}rŽ(jS]jT]jU]jV]jX]ujZM8jF]rj„)r}r‘(jKjjQ}r’(jS]jT]jU]jV]jX]ujLj‹jF]r“jdX $prefix/etcr”…r•}r–(jKUjLjubajOjŒubaubajOjµubj¨)r—}r˜(jKUjQ}r™(jS]jT]jU]jV]jX]ujLjljF]ršj{)r›}rœ(jKX``$prefix\etc``rjLj—jMjNjOj~jQ}rž(jS]jT]jU]jV]jX]ujZM9jF]rŸj„)r }r¡(jKX``$prefix\etc``jQ}r¢(jS]jT]jU]jV]jX]ujLj›jF]r£jdX $prefix\etcr¤…r¥}r¦(jKUjLj ubajOjŒubaubajOjµubejOjÎubj£)r§}r¨(jKUjQ}r©(jS]jT]jU]jV]jX]ujLjŸjF]rª(j¨)r«}r¬(jKUjQ}r­(jS]jT]jU]jV]jX]ujLj§jF]r®j{)r¯}r°(jKX:option:`--htmldir`r±jLj«jMjNjOj~jQ}r²(jS]jT]jU]jV]jX]ujZM:jF]r³j¯)r´}rµ(jKj±jLj¯jMjNjOj³jQ}r¶(UreftypeXoptionjµˆj¶X --htmldirU refdomainXstdr·jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM:jF]r¸j„)r¹}rº(jKj±jQ}r»(jS]jT]r¼(jÀj·X std-optionr½ejU]jV]jX]ujLj´jF]r¾jdX --htmldirr¿…rÀ}rÁ(jKUjLj¹ubajOjŒubaubaubajOjµubj¨)rÂ}rÃ(jKUjQ}rÄ(jS]jT]jU]jV]jX]ujLj§jF]rÅj{)rÆ}rÇ(jKX``$docdir/html``rÈjLjÂjMjNjOj~jQ}rÉ(jS]jT]jU]jV]jX]ujZM;jF]rÊj„)rË}rÌ(jKjÈjQ}rÍ(jS]jT]jU]jV]jX]ujLjÆjF]rÎjdX $docdir/htmlrÏ…rÐ}rÑ(jKUjLjËubajOjŒubaubajOjµubj¨)rÒ}rÓ(jKUjQ}rÔ(jS]jT]jU]jV]jX]ujLj§jF]rÕj{)rÖ}r×(jKX``$docdir\html``rØjLjÒjMjNjOj~jQ}rÙ(jS]jT]jU]jV]jX]ujZM<jF]rÚj„)rÛ}rÜ(jKX``$docdir\html``jQ}rÝ(jS]jT]jU]jV]jX]ujLjÖjF]rÞjdX $docdir\htmlrß…rà}rá(jKUjLjÛubajOjŒubaubajOjµubejOjÎubj£)râ}rã(jKUjQ}rä(jS]jT]jU]jV]jX]ujLjŸjF]rå(j¨)ræ}rç(jKUjQ}rè(jS]jT]jU]jV]jX]ujLjâjF]réj{)rê}rë(jKX:option:`--program-prefix`rìjLjæjMjNjOj~jQ}rí(jS]jT]jU]jV]jX]ujZM=jF]rîj¯)rï}rð(jKjìjLjêjMjNjOj³jQ}rñ(UreftypeXoptionjµˆj¶X--program-prefixU refdomainXstdròjV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM=jF]rój„)rô}rõ(jKjìjQ}rö(jS]jT]r÷(jÀjòX std-optionrøejU]jV]jX]ujLjïjF]rùjdX--program-prefixrú…rû}rü(jKUjLjôubajOjŒubaubaubajOjµubj¨)rý}rþ(jKUjQ}rÿ(jS]jT]jU]jV]jX]ujLjâjF]rj{)r}r(jKX(empty)rjLjýjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM>jF]rjdX(empty)r…r}r(jKjjLjubaubajOjµubj¨)r }r (jKUjQ}r (jS]jT]jU]jV]jX]ujLjâjF]r j{)r }r(jKX(empty)rjLj jMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZM?jF]rjdX(empty)r…r}r(jKjjLj ubaubajOjµubejOjÎubj£)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjŸjF]r(j¨)r}r(jKUjQ}r(jS]jT]jU]jV]jX]ujLjjF]rj{)r}r(jKX:option:`--program-suffix`rjLjjMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZM@jF]r!j¯)r"}r#(jKjjLjjMjNjOj³jQ}r$(UreftypeXoptionjµˆj¶X--program-suffixU refdomainXstdr%jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM@jF]r&j„)r'}r((jKjjQ}r)(jS]jT]r*(jÀj%X std-optionr+ejU]jV]jX]ujLj"jF]r,jdX--program-suffixr-…r.}r/(jKUjLj'ubajOjŒubaubaubajOjµubj¨)r0}r1(jKUjQ}r2(jS]jT]jU]jV]jX]ujLjjF]r3j{)r4}r5(jKX(empty)r6jLj0jMjNjOj~jQ}r7(jS]jT]jU]jV]jX]ujZMAjF]r8jdX(empty)r9…r:}r;(jKj6jLj4ubaubajOjµubj¨)r<}r=(jKUjQ}r>(jS]jT]jU]jV]jX]ujLjjF]r?j{)r@}rA(jKX(empty)rBjLj<jMjNjOj~jQ}rC(jS]jT]jU]jV]jX]ujZMBjF]rDjdX(empty)rE…rF}rG(jKjBjLj@ubaubajOjµubejOjÎubejOUtbodyrHubejOUtgrouprIubeubeubjH)rJ}rK(jKUjLj jMjNjOjPjQ}rL(jS]jT]jU]jV]rMhãajX]rNh;aujZMEj[hjF]rO(j])rP}rQ(jKXPrefix-independencerRjLjJjMjNjOjajQ}rS(jS]jT]jU]jV]jX]ujZMEj[hjF]rTjdXPrefix-independencerU…rV}rW(jKjRjMNjZNj[hjLjPubaubj{)rX}rY(jKXOn 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.jLjJjMjNjOj~jQ}rZ(jS]jT]jU]jV]jX]ujZMGj[hjF]r[(jdX>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\…r]}r^(jKX>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 jMNjZNj[hjLjXubj„)r_}r`(jKX ``$bindir``jQ}ra(jS]jT]jU]jV]jX]ujLjXjF]rbjdX$bindirrc…rd}re(jKUjLj_ubajOjŒubjdXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of rf…rg}rh(jKXs. Prefix-independence is particularly useful: it means the user can choose the install location (i.e. the value of jMNjZNj[hjLjXubj„)ri}rj(jKX ``$prefix``jQ}rk(jS]jT]jU]jV]jX]ujLjXjF]rljdX$prefixrm…rn}ro(jKUjLjiubajOjŒubjdXX) at install-time, rather than having to bake the path into the binary when it is built.rp…rq}rr(jKXX) at install-time, rather than having to bake the path into the binary when it is built.jMNjZNj[hjLjXubeubj{)rs}rt(jKX 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.jLjJjMjNjOj~jQ}ru(jS]jT]jU]jV]jX]ujZMPj[hjF]rv(jdXOIn order to achieve this, we require that for an executable on Windows, all of rw…rx}ry(jKXOIn order to achieve this, we require that for an executable on Windows, all of jMNjZNj[hjLjsubj„)rz}r{(jKX ``$bindir``jQ}r|(jS]jT]jU]jV]jX]ujLjsjF]r}jdX$bindirr~…r}r€(jKUjLjzubajOjŒubjdX, r…r‚}rƒ(jKX, r„jMNjZNj[hjLjsubj„)r…}r†(jKX ``$libdir``jQ}r‡(jS]jT]jU]jV]jX]ujLjsjF]rˆjdX$libdirr‰…rŠ}r‹(jKUjLj…ubajOjŒubjdX, rŒ…r}rŽ(jKX, jLjsubj„)r}r(jKX``$dynlibdir``jQ}r‘(jS]jT]jU]jV]jX]ujLjsjF]r’jdX $dynlibdirr“…r”}r•(jKUjLjubajOjŒubjdX, r–…r—}r˜(jKj„jLjsubj„)r™}rš(jKX ``$datadir``jQ}r›(jS]jT]jU]jV]jX]ujLjsjF]rœjdX$datadirr…rž}rŸ(jKUjLj™ubajOjŒubjdX and r …r¡}r¢(jKX and jMNjZNj[hjLjsubj„)r£}r¤(jKX``$libexecdir``jQ}r¥(jS]jT]jU]jV]jX]ujLjsjF]r¦jdX $libexecdirr§…r¨}r©(jKUjLj£ubajOjŒubjdX begin with rª…r«}r¬(jKX begin with jMNjZNj[hjLjsubj„)r­}r®(jKX ``$prefix``jQ}r¯(jS]jT]jU]jV]jX]ujLjsjF]r°jdX$prefixr±…r²}r³(jKUjLj­ubajOjŒubjdX]. If this is not the case then the compiled executable will have baked-in all absolute paths.r´…rµ}r¶(jKX]. If this is not the case then the compiled executable will have baked-in all absolute paths.jMNjZNj[hjLjsubeubj{)r·}r¸(jKX>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.jLjJjMjNjOj~jQ}r¹(jS]jT]jU]jV]jX]ujZMUj[hjF]rº(jdXdThe application need do nothing special to achieve prefix-independence. If it finds any files using r»…r¼}r½(jKXdThe application need do nothing special to achieve prefix-independence. If it finds any files using jMNjZNj[hjLj·ubj„)r¾}r¿(jKX``getDataFileName``jQ}rÀ(jS]jT]jU]jV]jX]ujLj·jF]rÁjdXgetDataFileNamerÂ…rÃ}rÄ(jKUjLj¾ubajOjŒubjdX and the rÅ…rÆ}rÇ(jKX and the jMNjZNj[hjLj·ubjž)rÈ}rÉ(jKXn`other functions provided for the purpose `__jQ}rÊ(UnameX(other functions provided for the purposejìX?developing-packages.html#accessing-data-files-from-package-codejV]jU]jS]jT]jX]ujLj·jF]rËjdX(other functions provided for the purposerÌ…rÍ}rÎ(jKUjLjÈubajOj§ubjdXP, the files will be accessed relative to the location of the current executable.rÏ…rÐ}rÑ(jKXP, the files will be accessed relative to the location of the current executable.jMNjZNj[hjLj·ubeubj{)rÒ}rÓ(jKX¥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ÔjLjJjMjNjOj~jQ}rÕ(jS]jT]jU]jV]jX]ujZM\j[hjF]rÖjdX¥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Ù(jKjÔjMNjZNj[hjLjÒubaubeubeubjH)rÚ}rÛ(jKUjLjfjMjNjOjPjQ}rÜ(jS]jT]jU]jV]rÝj:ajX]rÞh™aujZMaj[hjF]rß(j])rà}rá(jKXControlling Flag AssignmentsrâjLjÚjMjNjOjajQ}rã(jS]jT]jU]jV]jX]ujZMaj[hjF]räjdXControlling Flag Assignmentsrå…ræ}rç(jKjâjMNjZNj[hjLjàubaubj{)rè}ré(jKXºFlag assignments (see the `resolution of conditions and flags `__) can be controlled with the following command line options.jLjÚjMjNjOj~jQ}rê(jS]jT]jU]jV]jX]ujZMcj[hjF]rë(jdXFlag assignments (see the rì…rí}rî(jKXFlag assignments (see the jMNjZNj[hjLjèubjž)rï}rð(jKXd`resolution of conditions and flags `__jQ}rñ(UnameX"resolution of conditions and flagsjìX;developing-packages.html#resolution-of-conditions-and-flagsjV]jU]jS]jT]jX]ujLjèjF]ròjdX"resolution of conditions and flagsró…rô}rõ(jKUjLjïubajOj§ubjdX<) can be controlled with the following command line options.rö…r÷}rø(jKX<) can be controlled with the following command line options.jMNjZNj[hjLjèubeubj”)rù}rú(jKUjLjÚjMjNjOj—jQ}rû(jV]jU]jS]jT]jX]Uentries]rü(jšX@setup-configure command line option; -f flagname or -f -flagnamejDUNtrýaujZNj[hjF]ubjœ)rþ}rÿ(jKUjLjÚjMjNjOjŸjQ}r(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrj¥jujZNj[hjF]r(j§)r}r(jKX-f flagname or -f -flagnamejLjþjMjNjOjªjQ}r(j¬]rX-frajV]rjDajU]jS]jT]jX]r h£aj²‰ujZMmj[hjF]r (j´)r }r (jKjjLjjMjNjOj·jQ}r (j¿jÀjV]jU]jS]jT]jX]ujZMmj[hjF]rjdX-fr…r}r(jKUjMNjZNj[hjLj ubaubj½)r}r(jKX flagname or -f -flagnamejLjjMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMmj[hjF]rjdX flagname or -f -flagnamer…r}r(jKUjMNjZNj[hjLjubaubeubjØ)r}r(jKUjLjþjMjNjOjÛjQ}r(jS]jT]jU]jV]jX]ujZMmj[hjF]rj{)r}r(jKXÐ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``jLjjMjNjOj~jQ}r(jS]jT]jU]jV]jX]ujZMij[hjF]r (jdXForce the specified flag to r!…r"}r#(jKXForce the specified flag to jMNjZNj[hjLjubj„)r$}r%(jKX``true``jQ}r&(jS]jT]jU]jV]jX]ujLjjF]r'jdXtruer(…r)}r*(jKUjLj$ubajOjŒubjdX or r+…r,}r-(jKX or jMNjZNj[hjLjubj„)r.}r/(jKX ``false``jQ}r0(jS]jT]jU]jV]jX]ujLjjF]r1jdXfalser2…r3}r4(jKUjLj.ubajOjŒubjdX (if preceded with a r5…r6}r7(jKX (if preceded with a jMNjZNj[hjLjubj„)r8}r9(jKX``-``jQ}r:(jS]jT]jU]jV]jX]ujLjjF]r;jdX-…r<}r=(jKUjLj8ubajOjŒubjdXS). Later specifications for the same flags will override earlier, i.e., specifying r>…r?}r@(jKXS). Later specifications for the same flags will override earlier, i.e., specifying jMNjZNj[hjLjubj„)rA}rB(jKX``-fdebug -f-debug``jQ}rC(jS]jT]jU]jV]jX]ujLjjF]rDjdX-fdebug -f-debugrE…rF}rG(jKUjLjAubajOjŒubjdX is equivalent to rH…rI}rJ(jKX is equivalent to jMNjZNj[hjLjubj„)rK}rL(jKX ``-f-debug``jQ}rM(jS]jT]jU]jV]jX]ujLjjF]rNjdX-f-debugrO…rP}rQ(jKUjLjKubajOjŒubeubaubeubj”)rR}rS(jKUjLjÚjMjNjOj—jQ}rT(jV]jU]jS]jT]jX]Uentries]rU(jšX6setup-configure command line option; --flags=flagspecsjUNtrVaujZNj[hjF]ubjœ)rW}rX(jKUjLjÚjMjNjOjŸjQ}rY(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrZj¥jZujZNj[hjF]r[(j§)r\}r](jKX--flags=flagspecsjLjWjMjNjOjªjQ}r^(j¬]r_X--flagsr`ajV]rajajU]jS]jT]jX]rbhsaj²‰ujZMvj[hjF]rc(j´)rd}re(jKj`jLj\jMjNjOj·jQ}rf(j¿jÀjV]jU]jS]jT]jX]ujZMvj[hjF]rgjdX--flagsrh…ri}rj(jKUjMNjZNj[hjLjdubaubj½)rk}rl(jKX =flagspecsjLj\jMjNjOjÀjQ}rm(j¿jÀjV]jU]jS]jT]jX]ujZMvj[hjF]rnjdX =flagspecsro…rp}rq(jKUjMNjZNj[hjLjkubaubeubjØ)rr}rs(jKUjLjWjMjNjOjÛjQ}rt(jS]jT]jU]jV]jX]ujZMvj[hjF]ruj{)rv}rw(jKXESame 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``.jLjrjMjNjOj~jQ}rx(jS]jT]jU]jV]jX]ujZMpj[hjF]ry(jdXSame as rz…r{}r|(jKXSame as jMNjZNj[hjLjvubj„)r}}r~(jKX``-f``jQ}r(jS]jT]jU]jV]jX]ujLjvjF]r€jdX-fr…r‚}rƒ(jKUjLj}ubajOjŒubjdX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to r„…r…}r†(jKX…, but allows specifying multiple flag assignments at once. The parameter is a space-separated list of flag names (to force a flag to jMNjZNj[hjLjvubj„)r‡}rˆ(jKX``true``jQ}r‰(jS]jT]jU]jV]jX]ujLjvjF]rŠjdXtruer‹…rŒ}r(jKUjLj‡ubajOjŒubjdX), optionally preceded by a rŽ…r}r(jKX), optionally preceded by a jMNjZNj[hjLjvubj„)r‘}r’(jKX``-``jQ}r“(jS]jT]jU]jV]jX]ujLjvjF]r”jdX-…r•}r–(jKUjLj‘ubajOjŒubjdX (to force a flag to r—…r˜}r™(jKX (to force a flag to jMNjZNj[hjLjvubj„)rš}r›(jKX ``false``jQ}rœ(jS]jT]jU]jV]jX]ujLjvjF]rjdXfalserž…rŸ}r (jKUjLjšubajOjŒubjdX). For example, r¡…r¢}r£(jKX). For example, jMNjZNj[hjLjvubj„)r¤}r¥(jKX&``--flags="debug -feature1 feature2"``jQ}r¦(jS]jT]jU]jV]jX]ujLjvjF]r§jdX"--flags="debug -feature1 feature2"r¨…r©}rª(jKUjLj¤ubajOjŒubjdX is equivalent to r«…r¬}r­(jKX is equivalent to jMNjZNj[hjLjvubj„)r®}r¯(jKX"``-fdebug -f-feature1 -ffeature2``jQ}r°(jS]jT]jU]jV]jX]ujLjvjF]r±jdX-fdebug -f-feature1 -ffeature2r²…r³}r´(jKUjLj®ubajOjŒubjdX.…rµ}r¶(jKX.jMNjZNj[hjLjvubeubaubeubeubjH)r·}r¸(jKUjLjfjMjNjOjPjQ}r¹(jS]jT]jU]jV]rºhÊajX]r»h"aujZMxj[hjF]r¼(j])r½}r¾(jKXBuilding Test Suitesr¿jLj·jMjNjOjajQ}rÀ(jS]jT]jU]jV]jX]ujZMxj[hjF]rÁjdXBuilding Test SuitesrÂ…rÃ}rÄ(jKj¿jMNjZNj[hjLj½ubaubj”)rÅ}rÆ(jKUjLj·jMjNjOj—jQ}rÇ(jV]jU]jS]jT]jX]Uentries]rÈ(jšX3setup-configure command line option; --enable-testsj;UNtrÉaujZNj[hjF]ubjœ)rÊ}rË(jKUjLj·jMjNjOjŸjQ}rÌ(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÍj¥jÍujZNj[hjF]rÎ(j§)rÏ}rÐ(jKX--enable-testsrÑjLjÊjMjNjOjªjQ}rÒ(j¬]rÓjÑajV]rÔj;ajU]jS]jT]jX]rÕhšaj²‰ujZMj[hjF]rÖ(j´)r×}rØ(jKjÑjLjÏjMjNjOj·jQ}rÙ(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÚjdX--enable-testsrÛ…rÜ}rÝ(jKUjMNjZNj[hjLj×ubaubj½)rÞ}rß(jKUjLjÏjMjNjOjÀjQ}rà(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]ubeubjØ)rá}râ(jKUjLjÊjMjNjOjÛjQ}rã(jS]jT]jU]jV]jX]ujZMj[hjF]räj{)rå}ræ(jKXBuild 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.jLjájMjNjOj~jQ}rç(jS]jT]jU]jV]jX]ujZM|j[hjF]rè(jdXIBuild the test suites defined in the package description file during the ré…rê}rë(jKXIBuild the test suites defined in the package description file during the jMNjZNj[hjLjåubj„)rì}rí(jKX ``build``jQ}rî(jS]jT]jU]jV]jX]ujLjåjF]rïjdXbuildrð…rñ}rò(jKUjLjìubajOjŒubjdXŸ 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õ(jKXŸ 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 jMNjZNj[hjLjåubj„)rö}r÷(jKX``test``jQ}rø(jS]jT]jU]jV]jX]ujLjåjF]rùjdXtestrú…rû}rü(jKUjLjöubajOjŒubjdX$ command after the package is built.rý…rþ}rÿ(jKX$ command after the package is built.jMNjZNj[hjLjåubeubaubeubj”)r}r(jKUjLj·jMjNjOj—jQ}r(jV]jU]jS]jT]jX]Uentries]r(jšX4setup-configure command line option; --disable-testsj<UNtraujZNj[hjF]ubjœ)r}r(jKUjLj·jMjNjOjŸjQ}r(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrj¥jujZNj[hjF]r (j§)r }r (jKX--disable-testsr jLjjMjNjOjªjQ}r (j¬]rj ajV]rj<ajU]jS]jT]jX]rh›aj²‰ujZMˆj[hjF]r(j´)r}r(jKj jLj jMjNjOj·jQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMˆj[hjF]rjdX--disable-testsr…r}r(jKUjMNjZNj[hjLjubaubj½)r}r(jKUjLj jMjNjOjÀjQ}r(j¿jÀjV]jU]jS]jT]jX]ujZMˆj[hjF]ubeubjØ)r}r(jKUjLjjMjNjOjÛjQ}r(jS]jT]jU]jV]jX]ujZMˆj[hjF]rj{)r }r!(jKXÜ(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.jLjjMjNjOj~jQ}r"(jS]jT]jU]jV]jX]ujZM„j[hjF]r#(jdX2(default) Do not build any test suites during the r$…r%}r&(jKX2(default) Do not build any test suites during the jMNjZNj[hjLj ubj„)r'}r((jKX ``build``jQ}r)(jS]jT]jU]jV]jX]ujLj jF]r*jdXbuildr+…r,}r-(jKUjLj'ubajOjŒubjdXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the r.…r/}r0(jKXn stage. Do not check for dependencies required only by the test suites. It will not be possible to invoke the jMNjZNj[hjLj ubj„)r1}r2(jKX``test``jQ}r3(jS]jT]jU]jV]jX]ujLj jF]r4jdXtestr5…r6}r7(jKUjLj1ubajOjŒubjdX+ command without reconfiguring the package.r8…r9}r:(jKX+ command without reconfiguring the package.jMNjZNj[hjLj ubeubaubeubj”)r;}r<(jKUjLj·jMjNjOj—jQ}r=(jV]jU]jS]jT]jX]Uentries]r>(jšX6setup-configure command line option; --enable-coveragehþUNtr?aujZNj[hjF]ubjœ)r@}rA(jKUjLj·jMjNjOjŸjQ}rB(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrCj¥jCujZNj[hjF]rD(j§)rE}rF(jKX--enable-coveragerGjLj@jMjNjOjªjQ}rH(j¬]rIjGajV]rJhþajU]jS]jT]jX]rKhWaj²‰ujZMŽj[hjF]rL(j´)rM}rN(jKjGjLjEjMjNjOj·jQ}rO(j¿jÀjV]jU]jS]jT]jX]ujZMŽj[hjF]rPjdX--enable-coveragerQ…rR}rS(jKUjMNjZNj[hjLjMubaubj½)rT}rU(jKUjLjEjMjNjOjÀjQ}rV(j¿jÀjV]jU]jS]jT]jX]ujZMŽj[hjF]ubeubjØ)rW}rX(jKUjLj@jMjNjOjÛjQ}rY(jS]jT]jU]jV]jX]ujZMŽj[hjF]rZj{)r[}r\(jKX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.r]jLjWjMjNjOj~jQ}r^(jS]jT]jU]jV]jX]ujZM‹j[hjF]r_jdX­Build libraries and executables (including test suites) with Haskell Program Coverage enabled. Running the test suites will automatically generate coverage reports with HPC.r`…ra}rb(jKj]jMNjZNj[hjLj[ubaubaubeubj”)rc}rd(jKUjLj·jMjNjOj—jQ}re(jV]jU]jS]jT]jX]Uentries]rf(jšX7setup-configure command line option; --disable-coveragejUNtrgaujZNj[hjF]ubjœ)rh}ri(jKUjLj·jMjNjOjŸjQ}rj(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrkj¥jkujZNj[hjF]rl(j§)rm}rn(jKX--disable-coveragerojLjhjMjNjOjªjQ}rp(j¬]rqjoajV]rrjajU]jS]jT]jX]rsh{aj²‰ujZM’j[hjF]rt(j´)ru}rv(jKjojLjmjMjNjOj·jQ}rw(j¿jÀjV]jU]jS]jT]jX]ujZM’j[hjF]rxjdX--disable-coveragery…rz}r{(jKUjMNjZNj[hjLjuubaubj½)r|}r}(jKUjLjmjMjNjOjÀjQ}r~(j¿jÀjV]jU]jS]jT]jX]ujZM’j[hjF]ubeubjØ)r}r€(jKUjLjhjMjNjOjÛjQ}r(jS]jT]jU]jV]jX]ujZM’j[hjF]r‚j{)rƒ}r„(jKX1(default) Do not enable Haskell Program Coverage.r…jLjjMjNjOj~jQ}r†(jS]jT]jU]jV]jX]ujZM‘j[hjF]r‡jdX1(default) Do not enable Haskell Program Coverage.rˆ…r‰}rŠ(jKj…jMNjZNj[hjLjƒubaubaubeubeubjH)r‹}rŒ(jKUjLjfjMjNjOjPjQ}r(jS]jT]jU]jV]rŽhÄajX]rhaujZM”j[hjF]r(j])r‘}r’(jKXMiscellaneous optionsr“jLj‹jMjNjOjajQ}r”(jS]jT]jU]jV]jX]ujZM”j[hjF]r•jdXMiscellaneous optionsr–…r—}r˜(jKj“jMNjZNj[hjLj‘ubaubj”)r™}rš(jKUjLj‹jMjNjOj—jQ}r›(jV]jU]jS]jT]jX]Uentries]rœ(jšX+setup-configure command line option; --userhöUNtraujZNj[hjF]ubjœ)rž}rŸ(jKUjLj‹jMjNjOjŸjQ}r (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr¡j¥j¡ujZNj[hjF]r¢(j§)r£}r¤(jKX--userr¥jLjžjMjNjOjªjQ}r¦(j¬]r§j¥ajV]r¨höajU]jS]jT]jX]r©hOaj²‰ujZMŸj[hjF]rª(j´)r«}r¬(jKj¥jLj£jMjNjOj·jQ}r­(j¿jÀjV]jU]jS]jT]jX]ujZMŸj[hjF]r®jdX--userr¯…r°}r±(jKUjMNjZNj[hjLj«ubaubj½)r²}r³(jKUjLj£jMjNjOjÀjQ}r´(j¿jÀjV]jU]jS]jT]jX]ujZMŸj[hjF]ubeubjØ)rµ}r¶(jKUjLjžjMjNjOjÛjQ}r·(jS]jT]jU]jV]jX]ujZMŸj[hjF]r¸j{)r¹}rº(jKX¡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.jLjµjMjNjOj~jQ}r»(jS]jT]jU]jV]jX]ujZM˜j[hjF]r¼(jdX/Does a per-user installation. This changes the r½…r¾}r¿(jKX/Does a per-user installation. This changes the jMNjZNj[hjLj¹ubjž)rÀ}rÁ(jKXC`default installation prefix <#paths-in-the-simple-build-system>`__jQ}rÂ(UnameXdefault installation prefixjìX!#paths-in-the-simple-build-systemjV]jU]jS]jT]jX]ujLj¹jF]rÃjdXdefault installation prefixrÄ…rÅ}rÆ(jKUjLjÀubajOj§ubjdX’. 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É(jKX. 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 jMNjZNj[hjLj¹ubj„)rÊ}rË(jKX ``--user``jQ}rÌ(jS]jT]jU]jV]jX]ujLj¹jF]rÍjdX--userrÎ…rÏ}rÐ(jKUjLjÊubajOjŒubjdX for any subsequent rÑ…rÒ}rÓ(jKX for any subsequent jMNjZNj[hjLj¹ubj„)rÔ}rÕ(jKX ``install``jQ}rÖ(jS]jT]jU]jV]jX]ujLj¹jF]r×jdXinstallrØ…rÙ}rÚ(jKUjLjÔubajOjŒubjdXx command, as packages registered in the global database should not depend on packages registered in a user’s database.rÛ…rÜ}rÝ(jKXv command, as packages registered in the global database should not depend on packages registered in a user's database.jMNjZNj[hjLj¹ubeubaubeubj”)rÞ}rß(jKUjLj‹jMjNjOj—jQ}rà(jV]jU]jS]jT]jX]Uentries]rá(jšX-setup-configure command line option; --globalhºUNtrâaujZNj[hjF]ubjœ)rã}rä(jKUjLj‹jMjNjOjŸjQ}rå(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionræj¥jæujZNj[hjF]rç(j§)rè}ré(jKX--globalrêjLjãjMjNjOjªjQ}rë(j¬]rìjêajV]ríhºajU]jS]jT]jX]rîhaj²‰ujZM¦j[hjF]rï(j´)rð}rñ(jKjêjLjèjMjNjOj·jQ}rò(j¿jÀjV]jU]jS]jT]jX]ujZM¦j[hjF]rójdX--globalrô…rõ}rö(jKUjMNjZNj[hjLjðubaubj½)r÷}rø(jKUjLjèjMjNjOjÀjQ}rù(j¿jÀjV]jU]jS]jT]jX]ujZM¦j[hjF]ubeubjØ)rú}rû(jKUjLjãjMjNjOjÛjQ}rü(jS]jT]jU]jV]jX]ujZM¦j[hjF]rýj{)rþ}rÿ(jKX(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 jLjújMjNjOj~jQ}r (jS]jT]jU]jV]jX]ujZM¢j[hjF]r jdX(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 (jKj jMNjZNj[hjLjþubaubaubeubj”)r }r (jKUjLj‹jMjNjOj—jQ}r (jV]jU]jS]jT]jX]Uentries]r (jšX4setup-configure command line option; --package-db=dbj UNtr aujZNj[hjF]ubjœ)r }r (jKUjLj‹jMjNjOjŸjQ}r (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr j¥j ujZNj[hjF]r (j§)r }r (jKX--package-db=dbjLj jMjNjOjªjQ}r (j¬]r X --package-dbr ajV]r j ajU]jS]jT]jX]r hcaj²‰ujZM¸j[hjF]r (j´)r }r (jKj jLj jMjNjOj·jQ}r (j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]r jdX --package-dbr …r }r (jKUjMNjZNj[hjLj ubaubj½)r }r (jKX=dbjLj jMjNjOjÀjQ}r! (j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]r" jdX=dbr# …r$ }r% (jKUjMNjZNj[hjLj ubaubeubjØ)r& }r' (jKUjLj jMjNjOjÛjQ}r( (jS]jT]jU]jV]jX]ujZM¸j[hjF]r) (j{)r* }r+ (jKX]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.jLj& jMjNjOj~jQ}r, (jS]jT]jU]jV]jX]ujZM©j[hjF]r- (jdXRAllows package dependencies to be satisfied from this additional package database r. …r/ }r0 (jKXRAllows package dependencies to be satisfied from this additional package database jMNjZNj[hjLj* ubj¿)r1 }r2 (jKX*db*jQ}r3 (jS]jT]jU]jV]jX]ujLj* jF]r4 jdXdbr5 …r6 }r7 (jKUjLj1 ubajOjÇubjdX‚ in addition to the global package database. All packages in the user’s package database will be ignored. The interpretation of r8 …r9 }r: (jKX€ in addition to the global package database. All packages in the user's package database will be ignored. The interpretation of jMNjZNj[hjLj* ubj¿)r; }r< (jKX*db*jQ}r= (jS]jT]jU]jV]jX]ujLj* jF]r> jdXdbr? …r@ }rA (jKUjLj; ubajOjÇubjdXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.rB …rC }rD (jKXƒ is implementation-specific. Typically it will be a file or directory. Not all implementations support arbitrary package databases.jMNjZNj[hjLj* ubeubj{)rE }rF (jKXbThis 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.jLj& jMjNjOj~jQ}rG (jS]jT]jU]jV]jX]ujZM°j[hjF]rH (jdX/This pushes an extra db onto the db stack. The rI …rJ }rK (jKX/This pushes an extra db onto the db stack. The jMNjZNj[hjLjE ubj¯)rL }rM (jKX:option:`--global`rN jLjE jMjNjOj³jQ}rO (UreftypeXoptionjµˆj¶X--globalU refdomainXstdrP jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM°jF]rQ j„)rR }rS (jKjN jQ}rT (jS]jT]rU (jÀjP X std-optionrV ejU]jV]jX]ujLjL jF]rW jdX--globalrX …rY }rZ (jKUjLjR ubajOjŒubaubjdX and r[ …r\ }r] (jKX and jMNjZNj[hjLjE ubj¯)r^ }r_ (jKX:option:`--user`r` jLjE jMjNjOj³jQ}ra (UreftypeXoptionjµˆj¶X--userU refdomainXstdrb jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM°jF]rc j„)rd }re (jKj` jQ}rf (jS]jT]rg (jÀjb X std-optionrh ejU]jV]jX]ujLj^ jF]ri jdX--userrj …rk }rl (jKUjLjd ubajOjŒubaubjdX  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.rm …rn }ro (jKX  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.jMNjZNj[hjLjE ubeubj{)rp }rq (jKX/To reset the stack, use ``--package-db=clear``.jLj& jMjNjOj~jQ}rr (jS]jT]jU]jV]jX]ujZM·j[hjF]rs (jdXTo reset the stack, use rt …ru }rv (jKXTo reset the stack, use jMNjZNj[hjLjp ubj„)rw }rx (jKX``--package-db=clear``jQ}ry (jS]jT]jU]jV]jX]ujLjp jF]rz jdX--package-db=clearr{ …r| }r} (jKUjLjw ubajOjŒubjdX.…r~ }r (jKX.jMNjZNj[hjLjp ubeubeubeubj”)r€ }r (jKUjLj‹jMjNjOj—jQ}r‚ (jV]jU]jS]jT]jX]Uentries]rƒ (jšX0setup-configure command line option; --ipid=ipidj UNtr„ aujZNj[hjF]ubjœ)r… }r† (jKUjLj‹jMjNjOjŸjQ}r‡ (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrˆ j¥jˆ ujZNj[hjF]r‰ (j§)rŠ }r‹ (jKX --ipid=ipidjLj… jMjNjOjªjQ}rŒ (j¬]r X--ipidrŽ ajV]r j ajU]jS]jT]jX]r hbaj²‰ujZMÂj[hjF]r‘ (j´)r’ }r“ (jKjŽ jLjŠ jMjNjOj·jQ}r” (j¿jÀjV]jU]jS]jT]jX]ujZMÂj[hjF]r• jdX--ipidr– …r— }r˜ (jKUjMNjZNj[hjLj’ ubaubj½)r™ }rš (jKX=ipidjLjŠ jMjNjOjÀjQ}r› (j¿jÀjV]jU]jS]jT]jX]ujZMÂj[hjF]rœ jdX=ipidr …rž }rŸ (jKUjMNjZNj[hjLj™ ubaubeubjØ)r  }r¡ (jKUjLj… jMjNjOjÛjQ}r¢ (jS]jT]jU]jV]jX]ujZMÂj[hjF]r£ j{)r¤ }r¥ (jKX¢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``.jLj  jMjNjOj~jQ}r¦ (jS]jT]jU]jV]jX]ujZM»j[hjF]r§ (jdXSpecifies the r¨ …r© }rª (jKXSpecifies the jMNjZNj[hjLj¤ ubj¿)r« }r¬ (jKX*installed package identifier*jQ}r­ (jS]jT]jU]jV]jX]ujLj¤ jF]r® jdXinstalled package identifierr¯ …r° }r± (jKUjLj« ubajOjÇubjdXt 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´ (jKXt of the package to be built; this identifier is passed on to GHC and serves as the basis for linker symbols and the jMNjZNj[hjLj¤ ubj„)rµ }r¶ (jKX``id``jQ}r· (jS]jT]jU]jV]jX]ujLj¤ jF]r¸ jdXidr¹ …rº }r» (jKUjLjµ ubajOjŒubjdX field in a r¼ …r½ }r¾ (jKX field in a jMNjZNj[hjLj¤ ubj„)r¿ }rÀ (jKX ``ghc-pkg``jQ}rÁ (jS]jT]jU]jV]jX]ujLj¤ jF]r jdXghc-pkgrà …rÄ }rÅ (jKUjLj¿ ubajOjŒubjdX– 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È (jKX– registration. When a package has multiple components, the actual component identifiers are derived off of this identifier (e.g., an internal library jMNjZNj[hjLj¤ ubj„)rÉ }rÊ (jKX``foo``jQ}rË (jS]jT]jU]jV]jX]ujLj¤ jF]rÌ jdXfoorÍ …rÎ }rÏ (jKUjLjÉ ubajOjŒubjdX from package rÐ …rÑ }rÒ (jKX from package jMNjZNj[hjLj¤ ubj„)rÓ }rÔ (jKX``p-0.1-abcd``jQ}rÕ (jS]jT]jU]jV]jX]ujLj¤ jF]rÖ jdX p-0.1-abcdr× …rØ }rÙ (jKUjLjÓ ubajOjŒubjdX will get the identifier rÚ …rÛ }rÜ (jKX will get the identifier jMNjZNj[hjLj¤ ubj„)rÝ }rÞ (jKX``p-0.1-abcd-foo``jQ}rß (jS]jT]jU]jV]jX]ujLj¤ jF]rà jdXp-0.1-abcd-foorá …râ }rã (jKUjLjÝ ubajOjŒubjdX.…rä }rå (jKX.jMNjZNj[hjLj¤ ubeubaubeubj”)ræ }rç (jKUjLj‹jMjNjOj—jQ}rè (jV]jU]jS]jT]jX]Uentries]ré (jšX.setup-configure command line option; --cid=cidh®UNtrê aujZNj[hjF]ubjœ)rë }rì (jKUjLj‹jMjNjOjŸjQ}rí (j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrî j¥jî ujZNj[hjF]rï (j§)rð }rñ (jKX --cid=cidjLjë jMjNjOjªjQ}rò (j¬]ró X--cidrô ajV]rõ h®ajU]jS]jT]jX]rö haj²‰ujZMÇj[hjF]r÷ (j´)rø }rù (jKjô jLjð jMjNjOj·jQ}rú (j¿jÀjV]jU]jS]jT]jX]ujZMÇj[hjF]rû jdX--cidrü …rý }rþ (jKUjMNjZNj[hjLjø ubaubj½)rÿ }r!(jKX=cidjLjð jMjNjOjÀjQ}r!(j¿jÀjV]jU]jS]jT]jX]ujZMÇj[hjF]r!jdX=cidr!…r!}r!(jKUjMNjZNj[hjLjÿ ubaubeubjØ)r!}r!(jKUjLjë jMjNjOjÛjQ}r!(jS]jT]jU]jV]jX]ujZMÇj[hjF]r !j{)r !}r !(jKX€Specifies the *component identifier* of the component being built; this is only valid if you are configuring a single component.jLj!jMjNjOj~jQ}r !(jS]jT]jU]jV]jX]ujZMÅj[hjF]r !(jdXSpecifies the r!…r!}r!(jKXSpecifies the jMNjZNj[hjLj !ubj¿)r!}r!(jKX*component identifier*jQ}r!(jS]jT]jU]jV]jX]ujLj !jF]r!jdXcomponent identifierr!…r!}r!(jKUjLj!ubajOjÇubjdX\ of the component being built; this is only valid if you are configuring a single component.r!…r!}r!(jKX\ of the component being built; this is only valid if you are configuring a single component.jMNjZNj[hjLj !ubeubaubeubj”)r!}r!(jKUjLj‹jMjNjOj—jQ}r!(jV]jU]jS]jT]jX]Uentries]r!(jšX?setup-configure command line option; --default-user-config=filehÓUNtr!aujZNj[hjF]ubjœ)r !}r!!(jKUjLj‹jMjNjOjŸjQ}r"!(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr#!j¥j#!ujZNj[hjF]r$!(j§)r%!}r&!(jKX--default-user-config=filejLj !jMjNjOjªjQ}r'!(j¬]r(!X--default-user-configr)!ajV]r*!hÓajU]jS]jT]jX]r+!h+aj²‰ujZMÐj[hjF]r,!(j´)r-!}r.!(jKj)!jLj%!jMjNjOj·jQ}r/!(j¿jÀjV]jU]jS]jT]jX]ujZMÐj[hjF]r0!jdX--default-user-configr1!…r2!}r3!(jKUjMNjZNj[hjLj-!ubaubj½)r4!}r5!(jKX=filejLj%!jMjNjOjÀjQ}r6!(j¿jÀjV]jU]jS]jT]jX]ujZMÐj[hjF]r7!jdX=filer8!…r9!}r:!(jKUjMNjZNj[hjLj4!ubaubeubjØ)r;!}r!j{)r?!}r@!(jKXwAllows 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.jLj;!jMjNjOj~jQ}rA!(jS]jT]jU]jV]jX]ujZMÊj[hjF]rB!(jdXAllows a “default†rC!…rD!}rE!(jKXAllows a "default" jMNjZNj[hjLj?!ubj„)rF!}rG!(jKX``cabal.config``jQ}rH!(jS]jT]jU]jV]jX]ujLj?!jF]rI!jdX cabal.configrJ!…rK!}rL!(jKUjLjF!ubajOjŒubjdX¬ 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 rM!…rN!}rO!(jKX¬ 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 jMNjZNj[hjLj?!ubj„)rP!}rQ!(jKX ``config``jQ}rR!(jS]jT]jU]jV]jX]ujLj?!jF]rS!jdXconfigrT!…rU!}rV!(jKUjLjP!ubajOjŒubjdXž 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.rW!…rX!}rY!(jKXž 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.jMNjZNj[hjLj?!ubeubaubeubj”)rZ!}r[!(jKUjLj‹jMjNjOj—jQ}r\!(jV]jU]jS]jT]jX]Uentries]r]!(jšXHsetup-configure command line option; --enable-optimization[=n] or -O [n]jUNtr^!aujZNj[hjF]ubjœ)r_!}r`!(jKUjLj‹jMjNjOjŸjQ}ra!(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrb!j¥jb!ujZNj[hjF]rc!(j§)rd!}re!(jKX#--enable-optimization[=n] or -O [n]jLj_!jMjNjOjªjQ}rf!(j¬]rg!X--enable-optimization[rh!ajV]ri!jajU]jS]jT]jX]rj!hpaj²‰ujZMßj[hjF]rk!(j´)rl!}rm!(jKjh!jLjd!jMjNjOj·jQ}rn!(j¿jÀjV]jU]jS]jT]jX]ujZMßj[hjF]ro!jdX--enable-optimization[rp!…rq!}rr!(jKUjMNjZNj[hjLjl!ubaubj½)rs!}rt!(jKX =n] or -O [n]jLjd!jMjNjOjÀjQ}ru!(j¿jÀjV]jU]jS]jT]jX]ujZMßj[hjF]rv!jdX =n] or -O [n]rw!…rx!}ry!(jKUjMNjZNj[hjLjs!ubaubeubjØ)rz!}r{!(jKUjLj_!jMjNjOjÛjQ}r|!(jS]jT]jU]jV]jX]ujZMßj[hjF]r}!(j{)r~!}r!(jKX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.r€!jLjz!jMjNjOj~jQ}r!(jS]jT]jU]jV]jX]ujZMÓj[hjF]r‚!jdX˜(default) Build with optimization flags (if available). This is appropriate for production use, taking more time to build faster libraries and programs.rƒ!…r„!}r…!(jKj€!jMNjZNj[hjLj~!ubaubj{)r†!}r‡!(jKXtThe 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.jLjz!jMjNjOj~jQ}rˆ!(jS]jT]jU]jV]jX]ujZM×j[hjF]r‰!(jdX The optional rŠ!…r‹!}rŒ!(jKX The optional jMNjZNj[hjLj†!ubj¿)r!}rŽ!(jKX*n*jQ}r!(jS]jT]jU]jV]jX]ujLj†!jF]r!jdXn…r‘!}r’!(jKUjLj!ubajOjÇubjdX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to r“!…r”!}r•!(jKX… value is the optimisation level. Some compilers support multiple optimisation levels. The range is 0 to 2. Level 0 is equivalent to jMNjZNj[hjLj†!ubj¯)r–!}r—!(jKX :option:`--disable-optimization`r˜!jLj†!jMjNjOj³jQ}r™!(UreftypeXoptionjµˆj¶X--disable-optimizationU refdomainXstdrš!jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM×jF]r›!j„)rœ!}r!(jKj˜!jQ}rž!(jS]jT]rŸ!(jÀjš!X std-optionr !ejU]jV]jX]ujLj–!jF]r¡!jdX--disable-optimizationr¢!…r£!}r¤!(jKUjLjœ!ubajOjŒubaubjdX, level 1 is the default if no r¥!…r¦!}r§!(jKX, level 1 is the default if no jMNjZNj[hjLj†!ubj¿)r¨!}r©!(jKX*n*jQ}rª!(jS]jT]jU]jV]jX]ujLj†!jF]r«!jdXn…r¬!}r­!(jKUjLj¨!ubajOjÇubjdX 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°!(jKX 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.jMNjZNj[hjLj†!ubeubj{)r±!}r²!(jKXGWhen optimizations are enabled, Cabal passes ``-O2`` to the C compiler.jLjz!jMjNjOj~jQ}r³!(jS]jT]jU]jV]jX]ujZMÞj[hjF]r´!(jdX-When optimizations are enabled, Cabal passes rµ!…r¶!}r·!(jKX-When optimizations are enabled, Cabal passes jMNjZNj[hjLj±!ubj„)r¸!}r¹!(jKX``-O2``jQ}rº!(jS]jT]jU]jV]jX]ujLj±!jF]r»!jdX-O2r¼!…r½!}r¾!(jKUjLj¸!ubajOjŒubjdX to the C compiler.r¿!…rÀ!}rÁ!(jKX to the C compiler.jMNjZNj[hjLj±!ubeubeubeubj”)rÂ!}rÃ!(jKUjLj‹jMjNjOj—jQ}rÄ!(jV]jU]jS]jT]jX]Uentries]rÅ!(jšX;setup-configure command line option; --disable-optimizationhìUNtrÆ!aujZNj[hjF]ubjœ)rÇ!}rÈ!(jKUjLj‹jMjNjOjŸjQ}rÉ!(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÊ!j¥jÊ!ujZNj[hjF]rË!(j§)rÌ!}rÍ!(jKX--disable-optimizationrÎ!jLjÇ!jMjNjOjªjQ}rÏ!(j¬]rÐ!jÎ!ajV]rÑ!hìajU]jS]jT]jX]rÒ!hEaj²‰ujZMåj[hjF]rÓ!(j´)rÔ!}rÕ!(jKjÎ!jLjÌ!jMjNjOj·jQ}rÖ!(j¿jÀjV]jU]jS]jT]jX]ujZMåj[hjF]r×!jdX--disable-optimizationrØ!…rÙ!}rÚ!(jKUjMNjZNj[hjLjÔ!ubaubj½)rÛ!}rÜ!(jKUjLjÌ!jMjNjOjÀjQ}rÝ!(j¿jÀjV]jU]jS]jT]jX]ujZMåj[hjF]ubeubjØ)rÞ!}rß!(jKUjLjÇ!jMjNjOjÛjQ}rà!(jS]jT]jU]jV]jX]ujZMåj[hjF]rá!j{)râ!}rã!(jKX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.rä!jLjÞ!jMjNjOj~jQ}rå!(jS]jT]jU]jV]jX]ujZMâj[hjF]ræ!jdX‹Build without optimization. This is suited for development: building will be quicker, but the resulting library or programs will be slower.rç!…rè!}ré!(jKjä!jMNjZNj[hjLjâ!ubaubaubeubj”)rê!}rë!(jKUjLj‹jMjNjOj—jQ}rì!(jV]jU]jS]jT]jX]Uentries]rí!(jšX7setup-configure command line option; --enable-profilinghÌUNtrî!aujZNj[hjF]ubjœ)rï!}rð!(jKUjLj‹jMjNjOjŸjQ}rñ!(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrò!j¥jò!ujZNj[hjF]ró!(j§)rô!}rõ!(jKX--enable-profilingrö!jLjï!jMjNjOjªjQ}r÷!(j¬]rø!jö!ajV]rù!hÌajU]jS]jT]jX]rú!h$aj²‰ujZMôj[hjF]rû!(j´)rü!}rý!(jKjö!jLjô!jMjNjOj·jQ}rþ!(j¿jÀjV]jU]jS]jT]jX]ujZMôj[hjF]rÿ!jdX--enable-profilingr"…r"}r"(jKUjMNjZNj[hjLjü!ubaubj½)r"}r"(jKUjLjô!jMjNjOjÀjQ}r"(j¿jÀjV]jU]jS]jT]jX]ujZMôj[hjF]ubeubjØ)r"}r"(jKUjLjï!jMjNjOjÛjQ}r"(jS]jT]jU]jV]jX]ujZMôj[hjF]r "(j{)r "}r "(jKX¥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 "jLj"jMjNjOj~jQ}r "(jS]jT]jU]jV]jX]ujZMèj[hjF]r"jdX¥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"(jKj "jMNjZNj[hjLj "ubaubj{)r"}r"(jKXxThis flag covers both libraries and executables, but can be overridden by the :option:`--enable-library-profiling` flag.jLj"jMjNjOj~jQ}r"(jS]jT]jU]jV]jX]ujZMðj[hjF]r"(jdXNThis flag covers both libraries and executables, but can be overridden by the r"…r"}r"(jKXNThis flag covers both libraries and executables, but can be overridden by the jMNjZNj[hjLj"ubj¯)r"}r"(jKX$:option:`--enable-library-profiling`r"jLj"jMjNjOj³jQ}r"(UreftypeXoptionjµˆj¶X--enable-library-profilingU refdomainXstdr"jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMðjF]r"j„)r"}r "(jKj"jQ}r!"(jS]jT]r""(jÀj"X std-optionr#"ejU]jV]jX]ujLj"jF]r$"jdX--enable-library-profilingr%"…r&"}r'"(jKUjLj"ubajOjŒubaubjdX flag.r("…r)"}r*"(jKX flag.jMNjZNj[hjLj"ubeubj{)r+"}r,"(jKX5See also the :option:`--profiling-detail` flag below.jLj"jMjNjOj~jQ}r-"(jS]jT]jU]jV]jX]ujZMój[hjF]r."(jdX See also the r/"…r0"}r1"(jKX See also the jMNjZNj[hjLj+"ubj¯)r2"}r3"(jKX:option:`--profiling-detail`r4"jLj+"jMjNjOj³jQ}r5"(UreftypeXoptionjµˆj¶X--profiling-detailU refdomainXstdr6"jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMójF]r7"j„)r8"}r9"(jKj4"jQ}r:"(jS]jT]r;"(jÀj6"X std-optionr<"ejU]jV]jX]ujLj2"jF]r="jdX--profiling-detailr>"…r?"}r@"(jKUjLj8"ubajOjŒubaubjdX flag below.rA"…rB"}rC"(jKX flag below.jMNjZNj[hjLj+"ubeubeubeubj”)rD"}rE"(jKUjLj‹jMjNjOj—jQ}rF"(jV]jU]jS]jT]jX]Uentries]rG"(jšX8setup-configure command line option; --disable-profilingjUNtrH"aujZNj[hjF]ubjœ)rI"}rJ"(jKUjLj‹jMjNjOjŸjQ}rK"(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrL"j¥jL"ujZNj[hjF]rM"(j§)rN"}rO"(jKX--disable-profilingrP"jLjI"jMjNjOjªjQ}rQ"(j¬]rR"jP"ajV]rS"jajU]jS]jT]jX]rT"h[aj²‰ujZMùj[hjF]rU"(j´)rV"}rW"(jKjP"jLjN"jMjNjOj·jQ}rX"(j¿jÀjV]jU]jS]jT]jX]ujZMùj[hjF]rY"jdX--disable-profilingrZ"…r["}r\"(jKUjMNjZNj[hjLjV"ubaubj½)r]"}r^"(jKUjLjN"jMjNjOjÀjQ}r_"(j¿jÀjV]jU]jS]jT]jX]ujZMùj[hjF]ubeubjØ)r`"}ra"(jKUjLjI"jMjNjOjÛjQ}rb"(jS]jT]jU]jV]jX]ujZMùj[hjF]rc"j{)rd"}re"(jKXI(default) Do not enable profiling in generated libraries and executables.rf"jLj`"jMjNjOj~jQ}rg"(jS]jT]jU]jV]jX]ujZM÷j[hjF]rh"jdXI(default) Do not enable profiling in generated libraries and executables.ri"…rj"}rk"(jKjf"jMNjZNj[hjLjd"ubaubaubeubj”)rl"}rm"(jKUjLj‹jMjNjOj—jQ}rn"(jV]jU]jS]jT]jX]Uentries]ro"(jšXEsetup-configure command line option; --enable-library-profiling or -phÁUNtrp"aujZNj[hjF]ubjœ)rq"}rr"(jKUjLj‹jMjNjOjŸjQ}rs"(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrt"j¥jt"ujZNj[hjF]ru"(j§)rv"}rw"(jKX --enable-library-profiling or -pjLjq"jMjNjOjªjQ}rx"(j¬]ry"X--enable-library-profilingrz"ajV]r{"hÁajU]jS]jT]jX]r|"haj²‰ujZMj[hjF]r}"(j´)r~"}r"(jKjz"jLjv"jMjNjOj·jQ}r€"(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r"jdX--enable-library-profilingr‚"…rƒ"}r„"(jKUjMNjZNj[hjLj~"ubaubj½)r…"}r†"(jKX or -pjLjv"jMjNjOjÀjQ}r‡"(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rˆ"jdX or -pr‰"…rŠ"}r‹"(jKUjMNjZNj[hjLj…"ubaubeubjØ)rŒ"}r"(jKUjLjq"jMjNjOjÛjQ}rŽ"(jS]jT]jU]jV]jX]ujZMj[hjF]r"(j{)r"}r‘"(jKXÂ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.jLjŒ"jMjNjOj~jQ}r’"(jS]jT]jU]jV]jX]ujZMüj[hjF]r“"(jdXAs with r”"…r•"}r–"(jKXAs with jMNjZNj[hjLj"ubj¯)r—"}r˜"(jKX:option:`--enable-profiling`r™"jLj"jMjNjOj³jQ}rš"(UreftypeXoptionjµˆj¶X--enable-profilingU refdomainXstdr›"jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMüjF]rœ"j„)r"}rž"(jKj™"jQ}rŸ"(jS]jT]r "(jÀj›"X std-optionr¡"ejU]jV]jX]ujLj—"jF]r¢"jdX--enable-profilingr£"…r¤"}r¥"(jKUjLj"ubajOjŒubaubjdXž 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¨"(jKXž 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.jMNjZNj[hjLj"ubeubj{)r©"}rª"(jKXà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.jLjŒ"jMjNjOj~jQ}r«"(jS]jT]jU]jV]jX]ujZMj[hjF]r¬"(jdXThe r­"…r®"}r¯"(jKXThe jMNjZNj[hjLj©"ubj¯)r°"}r±"(jKX:option:`--enable-profiling`r²"jLj©"jMjNjOj³jQ}r³"(UreftypeXoptionjµˆj¶X--enable-profilingU refdomainXstdr´"jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]rµ"j„)r¶"}r·"(jKj²"jQ}r¸"(jS]jT]r¹"(jÀj´"X std-optionrº"ejU]jV]jX]ujLj°"jF]r»"jdX--enable-profilingr¼"…r½"}r¾"(jKUjLj¶"ubajOjŒubaubjdX“ 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Á"(jKX“ flag controls the profiling mode for both libraries and executables, but if different modes are desired for libraries versus executables then use jMNjZNj[hjLj©"ubj¯)rÂ"}rÃ"(jKX$:option:`--enable-library-profiling`rÄ"jLj©"jMjNjOj³jQ}rÅ"(UreftypeXoptionjµˆj¶X--enable-library-profilingU refdomainXstdrÆ"jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]rÇ"j„)rÈ"}rÉ"(jKjÄ"jQ}rÊ"(jS]jT]rË"(jÀjÆ"X std-optionrÌ"ejU]jV]jX]ujLjÂ"jF]rÍ"jdX--enable-library-profilingrÎ"…rÏ"}rÐ"(jKUjLjÈ"ubajOjŒubaubjdX as well.rÑ"…rÒ"}rÓ"(jKX as well.jMNjZNj[hjLj©"ubeubeubeubj”)rÔ"}rÕ"(jKUjLj‹jMjNjOj—jQ}rÖ"(jV]jU]jS]jT]jX]Uentries]r×"(jšX@setup-configure command line option; --disable-library-profilingháUNtrØ"aujZNj[hjF]ubjœ)rÙ"}rÚ"(jKUjLj‹jMjNjOjŸjQ}rÛ"(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÜ"j¥jÜ"ujZNj[hjF]rÝ"(j§)rÞ"}rß"(jKX--disable-library-profilingrà"jLjÙ"jMjNjOjªjQ}rá"(j¬]râ"jà"ajV]rã"háajU]jS]jT]jX]rä"h9aj²‰ujZMj[hjF]rå"(j´)ræ"}rç"(jKjà"jLjÞ"jMjNjOj·jQ}rè"(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]ré"jdX--disable-library-profilingrê"…rë"}rì"(jKUjMNjZNj[hjLjæ"ubaubj½)rí"}rî"(jKUjLjÞ"jMjNjOjÀjQ}rï"(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]ubeubjØ)rð"}rñ"(jKUjLjÙ"jMjNjOjÛjQ}rò"(jS]jT]jU]jV]jX]ujZMj[hjF]ró"j{)rô"}rõ"(jKXI(default) Do not generate an additional profiling version of the library.rö"jLjð"jMjNjOj~jQ}r÷"(jS]jT]jU]jV]jX]ujZMj[hjF]rø"jdXI(default) Do not generate an additional profiling version of the library.rù"…rú"}rû"(jKjö"jMNjZNj[hjLjô"ubaubaubeubj”)rü"}rý"(jKUjLj‹jMjNjOj—jQ}rþ"(jV]jU]jS]jT]jX]Uentries]rÿ"(jšX?setup-configure command line option; --profiling-detail[=level]jUNtr#aujZNj[hjF]ubjœ)r#}r#(jKUjLj‹jMjNjOjŸjQ}r#(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr#j¥j#ujZNj[hjF]r#(j§)r#}r#(jKX--profiling-detail[=level]r#jLj#jMjNjOjªjQ}r #(j¬]r #X--profiling-detail[r #ajV]r #jajU]jS]jT]jX]r #hhaj²‰ujZM-j[hjF]r#(j´)r#}r#(jKj #jLj#jMjNjOj·jQ}r#(j¿jÀjV]jU]jS]jT]jX]ujZM-j[hjF]r#jdX--profiling-detail[r#…r#}r#(jKUjMNjZNj[hjLj#ubaubj½)r#}r#(jKX=level]jLj#jMjNjOjÀjQ}r#(j¿jÀjV]jU]jS]jT]jX]ujZM-j[hjF]r#jdX=level]r#…r#}r#(jKUjMNjZNj[hjLj#ubaubeubjØ)r#}r#(jKUjLj#jMjNjOjÛjQ}r#(jS]jT]jU]jV]jX]ujZM-j[hjF]r #(j{)r!#}r"#(jKXGSome 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##jLj#jMjNjOj~jQ}r$#(jS]jT]jU]jV]jX]ujZM j[hjF]r%#jdXKSome 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(#(jKj##jMNjZNj[hjLj!#ubaubj{)r)#}r*#(jKXxThis flag covers both libraries and executables, but can be overridden by the :option:`--library-profiling-detail` flag.jLj#jMjNjOj~jQ}r+#(jS]jT]jU]jV]jX]ujZMj[hjF]r,#(jdXNThis flag covers both libraries and executables, but can be overridden by the r-#…r.#}r/#(jKXNThis flag covers both libraries and executables, but can be overridden by the jMNjZNj[hjLj)#ubj¯)r0#}r1#(jKX$:option:`--library-profiling-detail`r2#jLj)#jMjNjOj³jQ}r3#(UreftypeXoptionjµˆj¶X--library-profiling-detailU refdomainXstdr4#jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]r5#j„)r6#}r7#(jKj2#jQ}r8#(jS]jT]r9#(jÀj4#X std-optionr:#ejU]jV]jX]ujLj0#jF]r;#jdX--library-profiling-detailr<#…r=#}r>#(jKUjLj6#ubajOjŒubaubjdX flag.r?#…r@#}rA#(jKX flag.jMNjZNj[hjLj)#ubeubj{)rB#}rC#(jKXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:rD#jLj#jMjNjOj~jQ}rE#(jS]jT]jU]jV]jX]ujZMj[hjF]rF#jdXmCurrently this setting is ignored for compilers other than GHC. The levels that cabal currently supports are:rG#…rH#}rI#(jKjD#jMNjZNj[hjLjB#ubaubjî)rJ#}rK#(jKUjLj#jMjNjOjñjQ}rL#(jS]jT]jU]jV]jX]ujZNj[hjF]rM#(jô)rN#}rO#(jKXjdefault For GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jLjJ#jMjNjOj÷jQ}rP#(jS]jT]jU]jV]jX]ujZMjF]rQ#(jú)rR#}rS#(jKXdefaultrT#jLjN#jMjNjOjþjQ}rU#(jS]jT]jU]jV]jX]ujZMjF]rV#jdXdefaultrW#…rX#}rY#(jKjT#jLjR#ubaubj)rZ#}r[#(jKUjQ}r\#(jS]jT]jU]jV]jX]ujLjN#jF]r]#j{)r^#}r_#(jKXbFor GHC this uses ``exported-functions`` for libraries and ``toplevel-functions`` for executables.jLjZ#jMjNjOj~jQ}r`#(jS]jT]jU]jV]jX]ujZMjF]ra#(jdXFor GHC this uses rb#…rc#}rd#(jKXFor GHC this uses jLj^#ubj„)re#}rf#(jKX``exported-functions``jQ}rg#(jS]jT]jU]jV]jX]ujLj^#jF]rh#jdXexported-functionsri#…rj#}rk#(jKUjLje#ubajOjŒubjdX for libraries and rl#…rm#}rn#(jKX for libraries and jLj^#ubj„)ro#}rp#(jKX``toplevel-functions``jQ}rq#(jS]jT]jU]jV]jX]ujLj^#jF]rr#jdXtoplevel-functionsrs#…rt#}ru#(jKUjLjo#ubajOjŒubjdX for executables.rv#…rw#}rx#(jKX for executables.jLj^#ubeubajOjubeubjô)ry#}rz#(jKXAnone No costs will be assigned to any code within this component.jLjJ#jMjNjOj÷jQ}r{#(jS]jT]jU]jV]jX]ujZMj[hjF]r|#(jú)r}#}r~#(jKXnoner#jLjy#jMjNjOjþjQ}r€#(jS]jT]jU]jV]jX]ujZMjF]r#jdXnoner‚#…rƒ#}r„#(jKj#jLj}#ubaubj)r…#}r†#(jKUjQ}r‡#(jS]jT]jU]jV]jX]ujLjy#jF]rˆ#j{)r‰#}rŠ#(jKX<No costs will be assigned to any code within this component.r‹#jLj…#jMjNjOj~jQ}rŒ#(jS]jT]jU]jV]jX]ujZMjF]r#jdX<No costs will be assigned to any code within this component.rŽ#…r#}r#(jKj‹#jLj‰#ubaubajOjubeubjô)r‘#}r’#(jKX©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.jLjJ#jMjNjOj÷jQ}r“#(jS]jT]jU]jV]jX]ujZMj[hjF]r”#(jú)r•#}r–#(jKXexported-functionsr—#jLj‘#jMjNjOjþjQ}r˜#(jS]jT]jU]jV]jX]ujZMjF]r™#jdXexported-functionsrš#…r›#}rœ#(jKj—#jLj•#ubaubj)r#}rž#(jKUjQ}rŸ#(jS]jT]jU]jV]jX]ujLj‘#jF]r #j{)r¡#}r¢#(jKX–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£#jLj#jMjNjOj~jQ}r¤#(jS]jT]jU]jV]jX]ujZMjF]r¥#jdX–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¨#(jKj£#jLj¡#ubaubajOjubeubjô)r©#}rª#(jKXÐ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.jLjJ#jMjNjOj÷jQ}r«#(jS]jT]jU]jV]jX]ujZM#j[hjF]r¬#(jú)r­#}r®#(jKXtoplevel-functionsr¯#jLj©#jMjNjOjþjQ}r°#(jS]jT]jU]jV]jX]ujZM#jF]r±#jdXtoplevel-functionsr²#…r³#}r´#(jKj¯#jLj­#ubaubj)rµ#}r¶#(jKUjQ}r·#(jS]jT]jU]jV]jX]ujLj©#jF]r¸#j{)r¹#}rº#(jKX½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»#jLjµ#jMjNjOj~jQ}r¼#(jS]jT]jU]jV]jX]ujZM!jF]r½#jdX½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À#(jKj»#jLj¹#ubaubajOjubeubjô)rÁ#}rÂ#(jKXÎ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. jLjJ#jMjNjOj÷jQ}rÃ#(jS]jT]jU]jV]jX]ujZM)j[hjF]rÄ#(jú)rÅ#}rÆ#(jKX all-functionsrÇ#jLjÁ#jMjNjOjþjQ}rÈ#(jS]jT]jU]jV]jX]ujZM)jF]rÉ#jdX all-functionsrÊ#…rË#}rÌ#(jKjÇ#jLjÅ#ubaubj)rÍ#}rÎ#(jKUjQ}rÏ#(jS]jT]jU]jV]jX]ujLjÁ#jF]rÐ#j{)rÑ#}rÒ#(jKX¿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Ó#jLjÍ#jMjNjOj~jQ}rÔ#(jS]jT]jU]jV]jX]ujZM&jF]rÕ#jdX¿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Ø#(jKjÓ#jLjÑ#ubaubajOjubeubeubj{)rÙ#}rÚ#(jKXUThis flag is new in Cabal-1.24. Prior versions used the equivalent of ``none`` above.jLj#jMjNjOj~jQ}rÛ#(jS]jT]jU]jV]jX]ujZM+j[hjF]rÜ#(jdXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of rÝ#…rÞ#}rß#(jKXFThis flag is new in Cabal-1.24. Prior versions used the equivalent of jMNjZNj[hjLjÙ#ubj„)rà#}rá#(jKX``none``jQ}râ#(jS]jT]jU]jV]jX]ujLjÙ#jF]rã#jdXnonerä#…rå#}ræ#(jKUjLjà#ubajOjŒubjdX above.rç#…rè#}ré#(jKX above.jMNjZNj[hjLjÙ#ubeubeubeubj”)rê#}rë#(jKUjLj‹jMjNjOj—jQ}rì#(jV]jU]jS]jT]jX]Uentries]rí#(jšXGsetup-configure command line option; --library-profiling-detail[=level]hòUNtrî#aujZNj[hjF]ubjœ)rï#}rð#(jKUjLj‹jMjNjOjŸjQ}rñ#(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrò#j¥jò#ujZNj[hjF]ró#(j§)rô#}rõ#(jKX"--library-profiling-detail[=level]jLjï#jMjNjOjªjQ}rö#(j¬]r÷#X--library-profiling-detail[rø#ajV]rù#hòajU]jS]jT]jX]rú#hKaj²‰ujZM7j[hjF]rû#(j´)rü#}rý#(jKjø#jLjô#jMjNjOj·jQ}rþ#(j¿jÀjV]jU]jS]jT]jX]ujZM7j[hjF]rÿ#jdX--library-profiling-detail[r$…r$}r$(jKUjMNjZNj[hjLjü#ubaubj½)r$}r$(jKX=level]jLjô#jMjNjOjÀjQ}r$(j¿jÀjV]jU]jS]jT]jX]ujZM7j[hjF]r$jdX=level]r$…r$}r $(jKUjMNjZNj[hjLj$ubaubeubjØ)r $}r $(jKUjLjï#jMjNjOjÛjQ}r $(jS]jT]jU]jV]jX]ujZM7j[hjF]r $(j{)r$}r$(jKXNAs with :option:`--profiling-detail` above, but it applies only for libraries.jLj $jMjNjOj~jQ}r$(jS]jT]jU]jV]jX]ujZM0j[hjF]r$(jdXAs with r$…r$}r$(jKXAs with jMNjZNj[hjLj$ubj¯)r$}r$(jKX:option:`--profiling-detail`r$jLj$jMjNjOj³jQ}r$(UreftypeXoptionjµˆj¶X--profiling-detailU refdomainXstdr$jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM0jF]r$j„)r$}r$(jKj$jQ}r$(jS]jT]r$(jÀj$X std-optionr$ejU]jV]jX]ujLj$jF]r $jdX--profiling-detailr!$…r"$}r#$(jKUjLj$ubajOjŒubaubjdX* above, but it applies only for libraries.r$$…r%$}r&$(jKX* above, but it applies only for libraries.jMNjZNj[hjLj$ubeubj{)r'$}r($(jKXÙ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.jLj $jMjNjOj~jQ}r)$(jS]jT]jU]jV]jX]ujZM3j[hjF]r*$(jdX;The level for both libraries and executables is set by the r+$…r,$}r-$(jKX;The level for both libraries and executables is set by the jMNjZNj[hjLj'$ubj¯)r.$}r/$(jKX:option:`--profiling-detail`r0$jLj'$jMjNjOj³jQ}r1$(UreftypeXoptionjµˆj¶X--profiling-detailU refdomainXstdr2$jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM3jF]r3$j„)r4$}r5$(jKj0$jQ}r6$(jS]jT]r7$(jÀj2$X std-optionr8$ejU]jV]jX]ujLj.$jF]r9$jdX--profiling-detailr:$…r;$}r<$(jKUjLj4$ubajOjŒubaubjdXU flag, but if different levels are desired for libraries versus executables then use r=$…r>$}r?$(jKXU flag, but if different levels are desired for libraries versus executables then use jMNjZNj[hjLj'$ubj¯)r@$}rA$(jKX$:option:`--library-profiling-detail`rB$jLj'$jMjNjOj³jQ}rC$(UreftypeXoptionjµˆj¶X--library-profiling-detailU refdomainXstdrD$jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM3jF]rE$j„)rF$}rG$(jKjB$jQ}rH$(jS]jT]rI$(jÀjD$X std-optionrJ$ejU]jV]jX]ujLj@$jF]rK$jdX--library-profiling-detailrL$…rM$}rN$(jKUjLjF$ubajOjŒubaubjdX as well.rO$…rP$}rQ$(jKX as well.jMNjZNj[hjLj'$ubeubeubeubj”)rR$}rS$(jKUjLj‹jMjNjOj—jQ}rT$(jV]jU]jS]jT]jX]Uentries]rU$(jšX=setup-configure command line option; --enable-library-vanillajUNtrV$aujZNj[hjF]ubjœ)rW$}rX$(jKUjLj‹jMjNjOjŸjQ}rY$(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrZ$j¥jZ$ujZNj[hjF]r[$(j§)r\$}r]$(jKX--enable-library-vanillar^$jLjW$jMjNjOjªjQ}r_$(j¬]r`$j^$ajV]ra$jajU]jS]jT]jX]rb$hgaj²‰ujZM>j[hjF]rc$(j´)rd$}re$(jKj^$jLj\$jMjNjOj·jQ}rf$(j¿jÀjV]jU]jS]jT]jX]ujZM>j[hjF]rg$jdX--enable-library-vanillarh$…ri$}rj$(jKUjMNjZNj[hjLjd$ubaubj½)rk$}rl$(jKUjLj\$jMjNjOjÀjQ}rm$(j¿jÀjV]jU]jS]jT]jX]ujZM>j[hjF]ubeubjØ)rn$}ro$(jKUjLjW$jMjNjOjÛjQ}rp$(jS]jT]jU]jV]jX]ujZM>j[hjF]rq$j{)rr$}rs$(jKX±(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.jLjn$jMjNjOj~jQ}rt$(jS]jT]jU]jV]jX]ujZM:j[hjF]ru$(jdXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the rv$…rw$}rx$(jKXc(default) Build ordinary libraries (as opposed to profiling libraries). This is independent of the jMNjZNj[hjLjr$ubj¯)ry$}rz$(jKX$:option:`--enable-library-profiling`r{$jLjr$jMjNjOj³jQ}r|$(UreftypeXoptionjµˆj¶X--enable-library-profilingU refdomainXstdr}$jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM:jF]r~$j„)r$}r€$(jKj{$jQ}r$(jS]jT]r‚$(jÀj}$X std-optionrƒ$ejU]jV]jX]ujLjy$jF]r„$jdX--enable-library-profilingr…$…r†$}r‡$(jKUjLj$ubajOjŒubaubjdX* option. If you enable both, you get both.rˆ$…r‰$}rŠ$(jKX* option. If you enable both, you get both.jMNjZNj[hjLjr$ubeubaubeubj”)r‹$}rŒ$(jKUjLj‹jMjNjOj—jQ}r$(jV]jU]jS]jT]jX]Uentries]rŽ$(jšX>setup-configure command line option; --disable-library-vanillah½UNtr$aujZNj[hjF]ubjœ)r$}r‘$(jKUjLj‹jMjNjOjŸjQ}r’$(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr“$j¥j“$ujZNj[hjF]r”$(j§)r•$}r–$(jKX--disable-library-vanillar—$jLj$jMjNjOjªjQ}r˜$(j¬]r™$j—$ajV]rš$h½ajU]jS]jT]jX]r›$haj²‰ujZMDj[hjF]rœ$(j´)r$}rž$(jKj—$jLj•$jMjNjOj·jQ}rŸ$(j¿jÀjV]jU]jS]jT]jX]ujZMDj[hjF]r $jdX--disable-library-vanillar¡$…r¢$}r£$(jKUjMNjZNj[hjLj$ubaubj½)r¤$}r¥$(jKUjLj•$jMjNjOjÀjQ}r¦$(j¿jÀjV]jU]jS]jT]jX]ujZMDj[hjF]ubeubjØ)r§$}r¨$(jKUjLj$jMjNjOjÛjQ}r©$(jS]jT]jU]jV]jX]ujZMDj[hjF]rª$j{)r«$}r¬$(jKX¹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.jLj§$jMjNjOj~jQ}r­$(jS]jT]jU]jV]jX]ujZMAj[hjF]r®$(jdXDDo not build ordinary libraries. This is useful in conjunction with r¯$…r°$}r±$(jKXDDo not build ordinary libraries. This is useful in conjunction with jMNjZNj[hjLj«$ubj¯)r²$}r³$(jKX$:option:`--enable-library-profiling`r´$jLj«$jMjNjOj³jQ}rµ$(UreftypeXoptionjµˆj¶X--enable-library-profilingU refdomainXstdr¶$jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMAjF]r·$j„)r¸$}r¹$(jKj´$jQ}rº$(jS]jT]r»$(jÀj¶$X std-optionr¼$ejU]jV]jX]ujLj²$jF]r½$jdX--enable-library-profilingr¾$…r¿$}rÀ$(jKUjLj¸$ubajOjŒubaubjdXQ to build only profiling libraries, rather than profiling and ordinary libraries.rÁ$…rÂ$}rÃ$(jKXQ to build only profiling libraries, rather than profiling and ordinary libraries.jMNjZNj[hjLj«$ubeubaubeubj”)rÄ$}rÅ$(jKUjLj‹jMjNjOj—jQ}rÆ$(jV]jU]jS]jT]jX]Uentries]rÇ$(jšX>setup-configure command line option; --enable-library-for-ghcih°UNtrÈ$aujZNj[hjF]ubjœ)rÉ$}rÊ$(jKUjLj‹jMjNjOjŸjQ}rË$(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÌ$j¥jÌ$ujZNj[hjF]rÍ$(j§)rÎ$}rÏ$(jKX--enable-library-for-ghcirÐ$jLjÉ$jMjNjOjªjQ}rÑ$(j¬]rÒ$jÐ$ajV]rÓ$h°ajU]jS]jT]jX]rÔ$haj²‰ujZMHj[hjF]rÕ$(j´)rÖ$}r×$(jKjÐ$jLjÎ$jMjNjOj·jQ}rØ$(j¿jÀjV]jU]jS]jT]jX]ujZMHj[hjF]rÙ$jdX--enable-library-for-ghcirÚ$…rÛ$}rÜ$(jKUjMNjZNj[hjLjÖ$ubaubj½)rÝ$}rÞ$(jKUjLjÎ$jMjNjOjÀjQ}rß$(j¿jÀjV]jU]jS]jT]jX]ujZMHj[hjF]ubeubjØ)rà$}rá$(jKUjLjÉ$jMjNjOjÛjQ}râ$(jS]jT]jU]jV]jX]ujZMHj[hjF]rã$j{)rä$}rå$(jKX5(default) Build libraries suitable for use with GHCi.ræ$jLjà$jMjNjOj~jQ}rç$(jS]jT]jU]jV]jX]ujZMGj[hjF]rè$jdX5(default) Build libraries suitable for use with GHCi.ré$…rê$}rë$(jKjæ$jMNjZNj[hjLjä$ubaubaubeubj”)rì$}rí$(jKUjLj‹jMjNjOj—jQ}rî$(jV]jU]jS]jT]jX]Uentries]rï$(jšX?setup-configure command line option; --disable-library-for-ghcihÃUNtrð$aujZNj[hjF]ubjœ)rñ$}rò$(jKUjLj‹jMjNjOjŸjQ}ró$(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrô$j¥jô$ujZNj[hjF]rõ$(j§)rö$}r÷$(jKX--disable-library-for-ghcirø$jLjñ$jMjNjOjªjQ}rù$(j¬]rú$jø$ajV]rû$hÃajU]jS]jT]jX]rü$haj²‰ujZMNj[hjF]rý$(j´)rþ$}rÿ$(jKjø$jLjö$jMjNjOj·jQ}r%(j¿jÀjV]jU]jS]jT]jX]ujZMNj[hjF]r%jdX--disable-library-for-ghcir%…r%}r%(jKUjMNjZNj[hjLjþ$ubaubj½)r%}r%(jKUjLjö$jMjNjOjÀjQ}r%(j¿jÀjV]jU]jS]jT]jX]ujZMNj[hjF]ubeubjØ)r%}r %(jKUjLjñ$jMjNjOjÛjQ}r %(jS]jT]jU]jV]jX]ujZMNj[hjF]r %j{)r %}r %(jKX’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%jLj%jMjNjOj~jQ}r%(jS]jT]jU]jV]jX]ujZMKj[hjF]r%jdX’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%(jKj%jMNjZNj[hjLj %ubaubaubeubj”)r%}r%(jKUjLj‹jMjNjOj—jQ}r%(jV]jU]jS]jT]jX]Uentries]r%(jšX8setup-configure command line option; --enable-split-objshÇUNtr%aujZNj[hjF]ubjœ)r%}r%(jKUjLj‹jMjNjOjŸjQ}r%(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr%j¥j%ujZNj[hjF]r%(j§)r%}r%(jKX--enable-split-objsr %jLj%jMjNjOjªjQ}r!%(j¬]r"%j %ajV]r#%hÇajU]jS]jT]jX]r$%haj²‰ujZMVj[hjF]r%%(j´)r&%}r'%(jKj %jLj%jMjNjOj·jQ}r(%(j¿jÀjV]jU]jS]jT]jX]ujZMVj[hjF]r)%jdX--enable-split-objsr*%…r+%}r,%(jKUjMNjZNj[hjLj&%ubaubj½)r-%}r.%(jKUjLj%jMjNjOjÀjQ}r/%(j¿jÀjV]jU]jS]jT]jX]ujZMVj[hjF]ubeubjØ)r0%}r1%(jKUjLj%jMjNjOjÛjQ}r2%(jS]jT]jU]jV]jX]ujZMVj[hjF]r3%j{)r4%}r5%(jKX6Use 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.jLj0%jMjNjOj~jQ}r6%(jS]jT]jU]jV]jX]ujZMQj[hjF]r7%(jdX Use the GHC r8%…r9%}r:%(jKX Use the GHC jMNjZNj[hjLj4%ubj„)r;%}r<%(jKX``-split-objs``jQ}r=%(jS]jT]jU]jV]jX]ujLj4%jF]r>%jdX -split-objsr?%…r@%}rA%(jKUjLj;%ubajOjŒubjdX 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.rB%…rC%}rD%(jKX 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.jMNjZNj[hjLj4%ubeubaubeubj”)rE%}rF%(jKUjLj‹jMjNjOj—jQ}rG%(jV]jU]jS]jT]jX]Uentries]rH%(jšX9setup-configure command line option; --disable-split-objsj>UNtrI%aujZNj[hjF]ubjœ)rJ%}rK%(jKUjLj‹jMjNjOjŸjQ}rL%(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrM%j¥jM%ujZNj[hjF]rN%(j§)rO%}rP%(jKX--disable-split-objsrQ%jLjJ%jMjNjOjªjQ}rR%(j¬]rS%jQ%ajV]rT%j>ajU]jS]jT]jX]rU%haj²‰ujZM\j[hjF]rV%(j´)rW%}rX%(jKjQ%jLjO%jMjNjOj·jQ}rY%(j¿jÀjV]jU]jS]jT]jX]ujZM\j[hjF]rZ%jdX--disable-split-objsr[%…r\%}r]%(jKUjMNjZNj[hjLjW%ubaubj½)r^%}r_%(jKUjLjO%jMjNjOjÀjQ}r`%(j¿jÀjV]jU]jS]jT]jX]ujZM\j[hjF]ubeubjØ)ra%}rb%(jKUjLjJ%jMjNjOjÛjQ}rc%(jS]jT]jU]jV]jX]ujZM\j[hjF]rd%j{)re%}rf%(jKXœ(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.jLja%jMjNjOj~jQ}rg%(jS]jT]jU]jV]jX]ujZMYj[hjF]rh%(jdX(default) Do not use the GHC ri%…rj%}rk%(jKX(default) Do not use the GHC jMNjZNj[hjLje%ubj„)rl%}rm%(jKX``-split-objs``jQ}rn%(jS]jT]jU]jV]jX]ujLje%jF]ro%jdX -split-objsrp%…rq%}rr%(jKUjLjl%ubajOjŒubjdXp feature. This makes building the library quicker but the final executables that use the library will be larger.rs%…rt%}ru%(jKXp feature. This makes building the library quicker but the final executables that use the library will be larger.jMNjZNj[hjLje%ubeubaubeubj”)rv%}rw%(jKUjLj‹jMjNjOj—jQ}rx%(jV]jU]jS]jT]jX]Uentries]ry%(jšXBsetup-configure command line option; --enable-executable-strippinghøUNtrz%aujZNj[hjF]ubjœ)r{%}r|%(jKUjLj‹jMjNjOjŸjQ}r}%(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr~%j¥j~%ujZNj[hjF]r%(j§)r€%}r%(jKX--enable-executable-strippingr‚%jLj{%jMjNjOjªjQ}rƒ%(j¬]r„%j‚%ajV]r…%høajU]jS]jT]jX]r†%hQaj²‰ujZMhj[hjF]r‡%(j´)rˆ%}r‰%(jKj‚%jLj€%jMjNjOj·jQ}rŠ%(j¿jÀjV]jU]jS]jT]jX]ujZMhj[hjF]r‹%jdX--enable-executable-strippingrŒ%…r%}rŽ%(jKUjMNjZNj[hjLjˆ%ubaubj½)r%}r%(jKUjLj€%jMjNjOjÀjQ}r‘%(j¿jÀjV]jU]jS]jT]jX]ujZMhj[hjF]ubeubjØ)r’%}r“%(jKUjLj{%jMjNjOjÛjQ}r”%(jS]jT]jU]jV]jX]ujZMhj[hjF]r•%(j{)r–%}r—%(jKX…(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.jLj’%jMjNjOj~jQ}r˜%(jS]jT]jU]jV]jX]ujZM_j[hjF]r™%(jdX>(default) When installing binary executable programs, run the rš%…r›%}rœ%(jKX>(default) When installing binary executable programs, run the jMNjZNj[hjLj–%ubj„)r%}rž%(jKX ``strip``jQ}rŸ%(jS]jT]jU]jV]jX]ujLj–%jF]r %jdXstripr¡%…r¢%}r£%(jKUjLj%ubajOjŒubjdX> 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¦%(jKX> 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.jMNjZNj[hjLj–%ubeubj{)r§%}r¨%(jKXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r©%jLj’%jMjNjOj~jQ}rª%(jS]jT]jU]jV]jX]ujZMfj[hjF]r«%jdXmNot all Haskell implementations generate native binaries. For such implementations this option has no effect.r¬%…r­%}r®%(jKj©%jMNjZNj[hjLj§%ubaubeubeubj”)r¯%}r°%(jKUjLj‹jMjNjOj—jQ}r±%(jV]jU]jS]jT]jX]Uentries]r²%(jšXCsetup-configure command line option; --disable-executable-strippingj3UNtr³%aujZNj[hjF]ubjœ)r´%}rµ%(jKUjLj‹jMjNjOjŸjQ}r¶%(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr·%j¥j·%ujZNj[hjF]r¸%(j§)r¹%}rº%(jKX--disable-executable-strippingr»%jLj´%jMjNjOjªjQ}r¼%(j¬]r½%j»%ajV]r¾%j3ajU]jS]jT]jX]r¿%h’aj²‰ujZMqj[hjF]rÀ%(j´)rÁ%}rÂ%(jKj»%jLj¹%jMjNjOj·jQ}rÃ%(j¿jÀjV]jU]jS]jT]jX]ujZMqj[hjF]rÄ%jdX--disable-executable-strippingrÅ%…rÆ%}rÇ%(jKUjMNjZNj[hjLjÁ%ubaubj½)rÈ%}rÉ%(jKUjLj¹%jMjNjOjÀjQ}rÊ%(j¿jÀjV]jU]jS]jT]jX]ujZMqj[hjF]ubeubjØ)rË%}rÌ%(jKUjLj´%jMjNjOjÛjQ}rÍ%(jS]jT]jU]jV]jX]ujZMqj[hjF]rÎ%j{)rÏ%}rÐ%(jKXtDo 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Ñ%jLjË%jMjNjOj~jQ}rÒ%(jS]jT]jU]jV]jX]ujZMkj[hjF]rÓ%jdXtDo 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Ö%(jKjÑ%jMNjZNj[hjLjÏ%ubaubaubeubj”)r×%}rØ%(jKUjLj‹jMjNjOj—jQ}rÙ%(jV]jU]jS]jT]jX]Uentries]rÚ%(jšX4setup-configure command line option; --enable-sharedj+UNtrÛ%aujZNj[hjF]ubjœ)rÜ%}rÝ%(jKUjLj‹jMjNjOjŸjQ}rÞ%(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrß%j¥jß%ujZNj[hjF]rà%(j§)rá%}râ%(jKX--enable-sharedrã%jLjÜ%jMjNjOjªjQ}rä%(j¬]rå%jã%ajV]ræ%j+ajU]jS]jT]jX]rç%h‰aj²‰ujZMvj[hjF]rè%(j´)ré%}rê%(jKjã%jLjá%jMjNjOj·jQ}rë%(j¿jÀjV]jU]jS]jT]jX]ujZMvj[hjF]rì%jdX--enable-sharedrí%…rî%}rï%(jKUjMNjZNj[hjLjé%ubaubj½)rð%}rñ%(jKUjLjá%jMjNjOjÀjQ}rò%(j¿jÀjV]jU]jS]jT]jX]ujZMvj[hjF]ubeubjØ)ró%}rô%(jKUjLjÜ%jMjNjOjÛjQ}rõ%(jS]jT]jU]jV]jX]ujZMvj[hjF]rö%j{)r÷%}rø%(jKXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rù%jLjó%jMjNjOj~jQ}rú%(jS]jT]jU]jV]jX]ujZMtj[hjF]rû%jdXBuild shared library. This implies a separate compiler run to generate position independent code as required on most platforms.rü%…rý%}rþ%(jKjù%jMNjZNj[hjLj÷%ubaubaubeubj”)rÿ%}r&(jKUjLj‹jMjNjOj—jQ}r&(jV]jU]jS]jT]jX]Uentries]r&(jšX5setup-configure command line option; --disable-sharedhíUNtr&aujZNj[hjF]ubjœ)r&}r&(jKUjLj‹jMjNjOjŸjQ}r&(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr&j¥j&ujZNj[hjF]r&(j§)r &}r &(jKX--disable-sharedr &jLj&jMjNjOjªjQ}r &(j¬]r &j &ajV]r&híajU]jS]jT]jX]r&hFaj²‰ujZMzj[hjF]r&(j´)r&}r&(jKj &jLj &jMjNjOj·jQ}r&(j¿jÀjV]jU]jS]jT]jX]ujZMzj[hjF]r&jdX--disable-sharedr&…r&}r&(jKUjMNjZNj[hjLj&ubaubj½)r&}r&(jKUjLj &jMjNjOjÀjQ}r&(j¿jÀjV]jU]jS]jT]jX]ujZMzj[hjF]ubeubjØ)r&}r&(jKUjLj&jMjNjOjÛjQ}r&(jS]jT]jU]jV]jX]ujZMzj[hjF]r&j{)r&}r &(jKX&(default) Do not build shared library.r!&jLj&jMjNjOj~jQ}r"&(jS]jT]jU]jV]jX]ujZMyj[hjF]r#&jdX&(default) Do not build shared library.r$&…r%&}r&&(jKj!&jMNjZNj[hjLj&ubaubaubeubj”)r'&}r(&(jKUjLj‹jMjNjOj—jQ}r)&(jV]jU]jS]jT]jX]Uentries]r*&(jšX4setup-configure command line option; --enable-staticj4UNtr+&aujZNj[hjF]ubjœ)r,&}r-&(jKUjLj‹jMjNjOjŸjQ}r.&(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr/&j¥j/&ujZNj[hjF]r0&(j§)r1&}r2&(jKX--enable-staticr3&jLj,&jMjNjOjªjQ}r4&(j¬]r5&j3&ajV]r6&j4ajU]jS]jT]jX]r7&h“aj²‰ujZM€j[hjF]r8&(j´)r9&}r:&(jKj3&jLj1&jMjNjOj·jQ}r;&(j¿jÀjV]jU]jS]jT]jX]ujZM€j[hjF]r<&jdX--enable-staticr=&…r>&}r?&(jKUjMNjZNj[hjLj9&ubaubj½)r@&}rA&(jKUjLj1&jMjNjOjÀjQ}rB&(j¿jÀjV]jU]jS]jT]jX]ujZM€j[hjF]ubeubjØ)rC&}rD&(jKUjLj,&jMjNjOjÛjQ}rE&(jS]jT]jU]jV]jX]ujZM€j[hjF]rF&j{)rG&}rH&(jKXÂ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.jLjC&jMjNjOj~jQ}rI&(jS]jT]jU]jV]jX]ujZM}j[hjF]rJ&(jdX$Build a static library. This passes rK&…rL&}rM&(jKX$Build a static library. This passes jMNjZNj[hjLjG&ubj„)rN&}rO&(jKX``-staticlib``jQ}rP&(jS]jT]jU]jV]jX]ujLjG&jF]rQ&jdX -staticlibrR&…rS&}rT&(jKUjLjN&ubajOjŒubjdXT to GHC (available for iOS, and with 8.4 more platforms). The result is an archive rU&…rV&}rW&(jKXT to GHC (available for iOS, and with 8.4 more platforms). The result is an archive jMNjZNj[hjLjG&ubj„)rX&}rY&(jKX``.a``jQ}rZ&(jS]jT]jU]jV]jX]ujLjG&jF]r[&jdX.ar\&…r]&}r^&(jKUjLjX&ubajOjŒubjdX6 containing all dependent haskell libararies combined.r_&…r`&}ra&(jKX6 containing all dependent haskell libararies combined.jMNjZNj[hjLjG&ubeubaubeubj”)rb&}rc&(jKUjLj‹jMjNjOj—jQ}rd&(jV]jU]jS]jT]jX]Uentries]re&(jšX5setup-configure command line option; --disable-staticjUNtrf&aujZNj[hjF]ubjœ)rg&}rh&(jKUjLj‹jMjNjOjŸjQ}ri&(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrj&j¥jj&ujZNj[hjF]rk&(j§)rl&}rm&(jKX--disable-staticrn&jLjg&jMjNjOjªjQ}ro&(j¬]rp&jn&ajV]rq&jajU]jS]jT]jX]rr&hoaj²‰ujZM„j[hjF]rs&(j´)rt&}ru&(jKjn&jLjl&jMjNjOj·jQ}rv&(j¿jÀjV]jU]jS]jT]jX]ujZM„j[hjF]rw&jdX--disable-staticrx&…ry&}rz&(jKUjMNjZNj[hjLjt&ubaubj½)r{&}r|&(jKUjLjl&jMjNjOjÀjQ}r}&(j¿jÀjV]jU]jS]jT]jX]ujZM„j[hjF]ubeubjØ)r~&}r&(jKUjLjg&jMjNjOjÛjQ}r€&(jS]jT]jU]jV]jX]ujZM„j[hjF]r&j{)r‚&}rƒ&(jKX((default) Do not build a static library.r„&jLj~&jMjNjOj~jQ}r…&(jS]jT]jU]jV]jX]ujZMƒj[hjF]r†&jdX((default) Do not build a static library.r‡&…rˆ&}r‰&(jKj„&jMNjZNj[hjLj‚&ubaubaubeubj”)rŠ&}r‹&(jKUjLj‹jMjNjOj—jQ}rŒ&(jV]jU]jS]jT]jX]Uentries]r&(jšX@setup-configure command line option; --enable-executable-dynamicj#UNtrŽ&aujZNj[hjF]ubjœ)r&}r&(jKUjLj‹jMjNjOjŸjQ}r‘&(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr’&j¥j’&ujZNj[hjF]r“&(j§)r”&}r•&(jKX--enable-executable-dynamicr–&jLj&jMjNjOjªjQ}r—&(j¬]r˜&j–&ajV]r™&j#ajU]jS]jT]jX]rš&haj²‰ujZMŠj[hjF]r›&(j´)rœ&}r&(jKj–&jLj”&jMjNjOj·jQ}rž&(j¿jÀjV]jU]jS]jT]jX]ujZMŠj[hjF]rŸ&jdX--enable-executable-dynamicr &…r¡&}r¢&(jKUjMNjZNj[hjLjœ&ubaubj½)r£&}r¤&(jKUjLj”&jMjNjOjÀjQ}r¥&(j¿jÀjV]jU]jS]jT]jX]ujZMŠj[hjF]ubeubjØ)r¦&}r§&(jKUjLj&jMjNjOjÛjQ}r¨&(jS]jT]jU]jV]jX]ujZMŠj[hjF]r©&j{)rª&}r«&(jKXÈ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.jLj¦&jMjNjOj~jQ}r¬&(jS]jT]jU]jV]jX]ujZM‡j[hjF]r­&(jdXvLink executables dynamically. The executable’s library dependencies should be built as shared objects. This implies r®&…r¯&}r°&(jKXtLink executables dynamically. The executable's library dependencies should be built as shared objects. This implies jMNjZNj[hjLjª&ubj¯)r±&}r²&(jKX:option:`--enable-shared`r³&jLjª&jMjNjOj³jQ}r´&(UreftypeXoptionjµˆj¶X--enable-sharedU refdomainXstdrµ&jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM‡jF]r¶&j„)r·&}r¸&(jKj³&jQ}r¹&(jS]jT]rº&(jÀjµ&X std-optionr»&ejU]jV]jX]ujLj±&jF]r¼&jdX--enable-sharedr½&…r¾&}r¿&(jKUjLj·&ubajOjŒubaubjdX unless rÀ&…rÁ&}rÂ&(jKX unless jMNjZNj[hjLjª&ubj¯)rÃ&}rÄ&(jKX:option:`--disable-shared`rÅ&jLjª&jMjNjOj³jQ}rÆ&(UreftypeXoptionjµˆj¶X--disable-sharedU refdomainXstdrÇ&jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZM‡jF]rÈ&j„)rÉ&}rÊ&(jKjÅ&jQ}rË&(jS]jT]rÌ&(jÀjÇ&X std-optionrÍ&ejU]jV]jX]ujLjÃ&jF]rÎ&jdX--disable-sharedrÏ&…rÐ&}rÑ&(jKUjLjÉ&ubajOjŒubaubjdX is explicitly specified.rÒ&…rÓ&}rÔ&(jKX is explicitly specified.jMNjZNj[hjLjª&ubeubaubeubj”)rÕ&}rÖ&(jKUjLj‹jMjNjOj—jQ}r×&(jV]jU]jS]jT]jX]Uentries]rØ&(jšXAsetup-configure command line option; --disable-executable-dynamichüUNtrÙ&aujZNj[hjF]ubjœ)rÚ&}rÛ&(jKUjLj‹jMjNjOjŸjQ}rÜ&(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÝ&j¥jÝ&ujZNj[hjF]rÞ&(j§)rß&}rà&(jKX--disable-executable-dynamicrá&jLjÚ&jMjNjOjªjQ}râ&(j¬]rã&já&ajV]rä&hüajU]jS]jT]jX]rå&hUaj²‰ujZMŽj[hjF]ræ&(j´)rç&}rè&(jKjá&jLjß&jMjNjOj·jQ}ré&(j¿jÀjV]jU]jS]jT]jX]ujZMŽj[hjF]rê&jdX--disable-executable-dynamicrë&…rì&}rí&(jKUjMNjZNj[hjLjç&ubaubj½)rî&}rï&(jKUjLjß&jMjNjOjÀjQ}rð&(j¿jÀjV]jU]jS]jT]jX]ujZMŽj[hjF]ubeubjØ)rñ&}rò&(jKUjLjÚ&jMjNjOjÛjQ}ró&(jS]jT]jU]jV]jX]ujZMŽj[hjF]rô&j{)rõ&}rö&(jKX&(default) Link executables statically.r÷&jLjñ&jMjNjOj~jQ}rø&(jS]jT]jU]jV]jX]ujZMj[hjF]rù&jdX&(default) Link executables statically.rú&…rû&}rü&(jKj÷&jMNjZNj[hjLjõ&ubaubaubeubj”)rý&}rþ&(jKUjLj‹jMjNjOj—jQ}rÿ&(jV]jU]jS]jT]jX]Uentries]r'(jšX;setup-configure command line option; --configure-option=strj UNtr'aujZNj[hjF]ubjœ)r'}r'(jKUjLj‹jMjNjOjŸjQ}r'(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr'j¥j'ujZNj[hjF]r'(j§)r'}r'(jKX--configure-option=strjLj'jMjNjOjªjQ}r '(j¬]r 'X--configure-optionr 'ajV]r 'j ajU]jS]jT]jX]r 'heaj²‰ujZM•j[hjF]r'(j´)r'}r'(jKj 'jLj'jMjNjOj·jQ}r'(j¿jÀjV]jU]jS]jT]jX]ujZM•j[hjF]r'jdX--configure-optionr'…r'}r'(jKUjMNjZNj[hjLj'ubaubj½)r'}r'(jKX=strjLj'jMjNjOjÀjQ}r'(j¿jÀjV]jU]jS]jT]jX]ujZM•j[hjF]r'jdX=strr'…r'}r'(jKUjMNjZNj[hjLj'ubaubeubjØ)r'}r'(jKUjLj'jMjNjOjÛjQ}r'(jS]jT]jU]jV]jX]ujZM•j[hjF]r 'j{)r!'}r"'(jKX×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.jLj'jMjNjOj~jQ}r#'(jS]jT]jU]jV]jX]ujZM‘j[hjF]r$'(jdXAn extra option to an external r%'…r&'}r''(jKXAn extra option to an external jMNjZNj[hjLj!'ubj„)r('}r)'(jKX ``configure``jQ}r*'(jS]jT]jU]jV]jX]ujLj!'jF]r+'jdX configurer,'…r-'}r.'(jKUjLj('ubajOjŒubjdX, script, if one is used (see the section on r/'…r0'}r1'(jKX, script, if one is used (see the section on jMNjZNj[hjLj!'ubjž)r2'}r3'(jKXV`system-dependent parameters `__jQ}r4'(UnameXsystem-dependent parametersjìX4developing-packages.html#system-dependent-parametersjV]jU]jS]jT]jX]ujLj!'jF]r5'jdXsystem-dependent parametersr6'…r7'}r8'(jKUjLj2'ubajOj§ubjdX)). There can be several of these options.r9'…r:'}r;'(jKX)). There can be several of these options.jMNjZNj[hjLj!'ubeubaubeubj”)r<'}r='(jKUjLj‹jMjNjOj—jQ}r>'(jV]jU]jS]jT]jX]Uentries]r?'(jšX?setup-configure command line option; --extra-include-dirs[=dir]húUNtr@'aujZNj[hjF]ubjœ)rA'}rB'(jKUjLj‹jMjNjOjŸjQ}rC'(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrD'j¥jD'ujZNj[hjF]rE'(j§)rF'}rG'(jKX--extra-include-dirs[=dir]jLjA'jMjNjOjªjQ}rH'(j¬]rI'X--extra-include-dirs[rJ'ajV]rK'húajU]jS]jT]jX]rL'hSaj²‰ujZM¤j[hjF]rM'(j´)rN'}rO'(jKjJ'jLjF'jMjNjOj·jQ}rP'(j¿jÀjV]jU]jS]jT]jX]ujZM¤j[hjF]rQ'jdX--extra-include-dirs[rR'…rS'}rT'(jKUjMNjZNj[hjLjN'ubaubj½)rU'}rV'(jKX=dir]jLjF'jMjNjOjÀjQ}rW'(j¿jÀjV]jU]jS]jT]jX]ujZM¤j[hjF]rX'jdX=dir]rY'…rZ'}r['(jKUjMNjZNj[hjLjU'ubaubeubjØ)r\'}r]'(jKUjLjA'jMjNjOjÛjQ}r^'(jS]jT]jU]jV]jX]ujZM¤j[hjF]r_'(j{)r`'}ra'(jKXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.rb'jLj\'jMjNjOj~jQ}rc'(jS]jT]jU]jV]jX]ujZM˜j[hjF]rd'jdXsAn extra directory to search for C header files. You can use this flag multiple times to get a list of directories.re'…rf'}rg'(jKjb'jMNjZNj[hjLj`'ubaubj{)rh'}ri'(jKXPYou 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.jLj\'jMjNjOj~jQ}rj'(jS]jT]jU]jV]jX]ujZM›j[hjF]rk'(jdXYou 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 rl'…rm'}rn'(jKX‹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 jMNjZNj[hjLjh'ubj„)ro'}rp'(jKX ``.cabal``jQ}rq'(jS]jT]jU]jV]jX]ujLjh'jF]rr'jdX.cabalrs'…rt'}ru'(jKUjLjo'ubajOjŒubjdXH file. Using this option has the same affect as appending the directory rv'…rw'}rx'(jKXH file. Using this option has the same affect as appending the directory jMNjZNj[hjLjh'ubj¿)ry'}rz'(jKX*dir*jQ}r{'(jS]jT]jU]jV]jX]ujLjh'jF]r|'jdXdirr}'…r~'}r'(jKUjLjy'ubajOjÇubjdX to the r€'…r'}r‚'(jKX to the jMNjZNj[hjLjh'ubj„)rƒ'}r„'(jKX``include-dirs``jQ}r…'(jS]jT]jU]jV]jX]ujLjh'jF]r†'jdX include-dirsr‡'…rˆ'}r‰'(jKUjLjƒ'ubajOjŒubjdX9 field in each library and executable in the package’s rŠ'…r‹'}rŒ'(jKX7 field in each library and executable in the package's jMNjZNj[hjLjh'ubj„)r'}rŽ'(jKX ``.cabal``jQ}r'(jS]jT]jU]jV]jX]ujLjh'jF]r'jdX.cabalr‘'…r’'}r“'(jKUjLj'ubajOjŒubjdX 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–'(jKX 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.jMNjZNj[hjLjh'ubeubeubeubj”)r—'}r˜'(jKUjLj‹jMjNjOj—jQ}r™'(jV]jU]jS]jT]jX]Uentries]rš'(jšX;setup-configure command line option; --extra-lib-dirs[=dir]hÐUNtr›'aujZNj[hjF]ubjœ)rœ'}r'(jKUjLj‹jMjNjOjŸjQ}rž'(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrŸ'j¥jŸ'ujZNj[hjF]r '(j§)r¡'}r¢'(jKX--extra-lib-dirs[=dir]jLjœ'jMjNjOjªjQ}r£'(j¬]r¤'X--extra-lib-dirs[r¥'ajV]r¦'hÐajU]jS]jT]jX]r§'h(aj²‰ujZM©j[hjF]r¨'(j´)r©'}rª'(jKj¥'jLj¡'jMjNjOj·jQ}r«'(j¿jÀjV]jU]jS]jT]jX]ujZM©j[hjF]r¬'jdX--extra-lib-dirs[r­'…r®'}r¯'(jKUjMNjZNj[hjLj©'ubaubj½)r°'}r±'(jKX=dir]jLj¡'jMjNjOjÀjQ}r²'(j¿jÀjV]jU]jS]jT]jX]ujZM©j[hjF]r³'jdX=dir]r´'…rµ'}r¶'(jKUjMNjZNj[hjLj°'ubaubeubjØ)r·'}r¸'(jKUjLjœ'jMjNjOjÛjQ}r¹'(jS]jT]jU]jV]jX]ujZM©j[hjF]rº'j{)r»'}r¼'(jKX{An extra directory to search for system libraries files. You can use this flag multiple times to get a list of directories.r½'jLj·'jMjNjOj~jQ}r¾'(jS]jT]jU]jV]jX]ujZM§j[hjF]r¿'jdX{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Â'(jKj½'jMNjZNj[hjLj»'ubaubaubeubj”)rÃ'}rÄ'(jKUjLj‹jMjNjOj—jQ}rÅ'(jV]jU]jS]jT]jX]Uentries]rÆ'(jšXAsetup-configure command line option; --extra-framework-dirs[=dir]j@UNtrÇ'aujZNj[hjF]ubjœ)rÈ'}rÉ'(jKUjLj‹jMjNjOjŸjQ}rÊ'(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrË'j¥jË'ujZNj[hjF]rÌ'(j§)rÍ'}rÎ'(jKX--extra-framework-dirs[=dir]jLjÈ'jMjNjOjªjQ}rÏ'(j¬]rÐ'X--extra-framework-dirs[rÑ'ajV]rÒ'j@ajU]jS]jT]jX]rÓ'hŸaj²‰ujZM¸j[hjF]rÔ'(j´)rÕ'}rÖ'(jKjÑ'jLjÍ'jMjNjOj·jQ}r×'(j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]rØ'jdX--extra-framework-dirs[rÙ'…rÚ'}rÛ'(jKUjMNjZNj[hjLjÕ'ubaubj½)rÜ'}rÝ'(jKX=dir]jLjÍ'jMjNjOjÀjQ}rÞ'(j¿jÀjV]jU]jS]jT]jX]ujZM¸j[hjF]rß'jdX=dir]rà'…rá'}râ'(jKUjMNjZNj[hjLjÜ'ubaubeubjØ)rã'}rä'(jKUjLjÈ'jMjNjOjÛjQ}rå'(jS]jT]jU]jV]jX]ujZM¸j[hjF]ræ'(j{)rç'}rè'(jKX{An extra directory to search for frameworks (OS X only). You can use this flag multiple times to get a list of directories.ré'jLjã'jMjNjOj~jQ}rê'(jS]jT]jU]jV]jX]ujZM¬j[hjF]rë'jdX{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î'(jKjé'jMNjZNj[hjLjç'ubaubj{)rï'}rð'(jKXOYou 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.jLjã'jMjNjOj~jQ}rñ'(jS]jT]jU]jV]jX]ujZM¯j[hjF]rò'(jdXŠ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õ'(jKXˆ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 jMNjZNj[hjLjï'ubj„)rö'}r÷'(jKX ``.cabal``jQ}rø'(jS]jT]jU]jV]jX]ujLjï'jF]rù'jdX.cabalrú'…rû'}rü'(jKUjLjö'ubajOjŒubjdXH file. Using this option has the same affect as appending the directory rý'…rþ'}rÿ'(jKXH file. Using this option has the same affect as appending the directory jMNjZNj[hjLjï'ubj¿)r(}r((jKX*dir*jQ}r((jS]jT]jU]jV]jX]ujLjï'jF]r(jdXdirr(…r(}r((jKUjLj(ubajOjÇubjdX to the r(…r(}r ((jKX to the jMNjZNj[hjLjï'ubj„)r (}r ((jKX``extra-lib-dirs``jQ}r ((jS]jT]jU]jV]jX]ujLjï'jF]r (jdXextra-lib-dirsr(…r(}r((jKUjLj (ubajOjŒubjdX9 field in each library and executable in the package’s r(…r(}r((jKX7 field in each library and executable in the package's jMNjZNj[hjLjï'ubj„)r(}r((jKX ``.cabal``jQ}r((jS]jT]jU]jV]jX]ujLjï'jF]r(jdX.cabalr(…r(}r((jKUjLj(ubajOjŒubjdX 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((jKX 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.jMNjZNj[hjLjï'ubeubeubeubj”)r(}r((jKUjLj‹jMjNjOj—jQ}r ((jV]jU]jS]jT]jX]Uentries]r!((jšX@setup-configure command line option; --dependency[=pkgname=ipid]hÕUNtr"(aujZNj[hjF]ubjœ)r#(}r$((jKUjLj‹jMjNjOjŸjQ}r%((j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr&(j¥j&(ujZNj[hjF]r'((j§)r((}r)((jKX--dependency[=pkgname=ipid]jLj#(jMjNjOjªjQ}r*((j¬]r+(X --dependency[r,(ajV]r-(hÕajU]jS]jT]jX]r.(h-aj²‰ujZM¾j[hjF]r/((j´)r0(}r1((jKj,(jLj((jMjNjOj·jQ}r2((j¿jÀjV]jU]jS]jT]jX]ujZM¾j[hjF]r3(jdX --dependency[r4(…r5(}r6((jKUjMNjZNj[hjLj0(ubaubj½)r7(}r8((jKX=pkgname=ipid]jLj((jMjNjOjÀjQ}r9((j¿jÀjV]jU]jS]jT]jX]ujZM¾j[hjF]r:(jdX=pkgname=ipid]r;(…r<(}r=((jKUjMNjZNj[hjLj7(ubaubeubjØ)r>(}r?((jKUjLj#(jMjNjOjÛjQ}r@((jS]jT]jU]jV]jX]ujZM¾j[hjF]rA(j{)rB(}rC((jKX¿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*.jLj>(jMjNjOj~jQ}rD((jS]jT]jU]jV]jX]ujZM»j[hjF]rE((jdXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to rF(…rG(}rH((jKXSpecify that a particular dependency should used for a particular package name. In particular, it declares that any reference to jMNjZNj[hjLjB(ubj¿)rI(}rJ((jKX *pkgname*jQ}rK((jS]jT]jU]jV]jX]ujLjB(jF]rL(jdXpkgnamerM(…rN(}rO((jKUjLjI(ubajOjÇubjdX in a rP(…rQ(}rR((jKX in a jMNjZNj[hjLjB(ubj„)rS(}rT((jKX``build-depends``jQ}rU((jS]jT]jU]jV]jX]ujLjB(jF]rV(jdX build-dependsrW(…rX(}rY((jKUjLjS(ubajOjŒubjdX should be resolved to rZ(…r[(}r\((jKX should be resolved to jMNjZNj[hjLjB(ubj¿)r](}r^((jKX*ipid*jQ}r_((jS]jT]jU]jV]jX]ujLjB(jF]r`(jdXipidra(…rb(}rc((jKUjLj](ubajOjÇubjdX.…rd(}re((jKX.jMNjZNj[hjLjB(ubeubaubeubj”)rf(}rg((jKUjLj‹jMjNjOj—jQ}rh((jV]jU]jS]jT]jX]Uentries]ri((jšX:setup-configure command line option; --exact-configurationj0UNtrj(aujZNj[hjF]ubjœ)rk(}rl((jKUjLj‹jMjNjOjŸjQ}rm((j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrn(j¥jn(ujZNj[hjF]ro((j§)rp(}rq((jKX--exact-configurationrr(jLjk(jMjNjOjªjQ}rs((j¬]rt(jr(ajV]ru(j0ajU]jS]jT]jX]rv(hŽaj²‰ujZMÆj[hjF]rw((j´)rx(}ry((jKjr(jLjp(jMjNjOj·jQ}rz((j¿jÀjV]jU]jS]jT]jX]ujZMÆj[hjF]r{(jdX--exact-configurationr|(…r}(}r~((jKUjMNjZNj[hjLjx(ubaubj½)r(}r€((jKUjLjp(jMjNjOjÀjQ}r((j¿jÀjV]jU]jS]jT]jX]ujZMÆj[hjF]ubeubjØ)r‚(}rƒ((jKUjLjk(jMjNjOjÛjQ}r„((jS]jT]jU]jV]jX]ujZMÆj[hjF]r…(j{)r†(}r‡((jKX$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.jLj‚(jMjNjOj~jQ}rˆ((jS]jT]jU]jV]jX]ujZMÁj[hjF]r‰((jdXMThis changes Cabal to require every dependency be explicitly specified using rŠ(…r‹(}rŒ((jKXMThis changes Cabal to require every dependency be explicitly specified using jMNjZNj[hjLj†(ubj¯)r(}rŽ((jKX:option:`--dependency`r(jLj†(jMjNjOj³jQ}r((UreftypeXoptionjµˆj¶X --dependencyU refdomainXstdr‘(jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÁjF]r’(j„)r“(}r”((jKj(jQ}r•((jS]jT]r–((jÀj‘(X std-optionr—(ejU]jV]jX]ujLj(jF]r˜(jdX --dependencyr™(…rš(}r›((jKUjLj“(ubajOjŒubaubjdXª, 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ž((jKX¤, 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 jMNjZNj[hjLj†(ubj¯)rŸ(}r ((jKX:option:`--dependency`r¡(jLj†(jMjNjOj³jQ}r¢((UreftypeXoptionjµˆj¶X --dependencyU refdomainXstdr£(jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÁjF]r¤(j„)r¥(}r¦((jKj¡(jQ}r§((jS]jT]r¨((jÀj£(X std-optionr©(ejU]jV]jX]ujLjŸ(jF]rª(jdX --dependencyr«(…r¬(}r­((jKUjLj¥(ubajOjŒubaubjdX flags.r®(…r¯(}r°((jKX flags.jMNjZNj[hjLj†(ubeubaubeubj”)r±(}r²((jKUjLj‹jMjNjOj—jQ}r³((jV]jU]jS]jT]jX]Uentries]r´((jšXOsetup-configure command line option; --allow-newer[=pkgs], --allow-older[=pkgs]hàUNtrµ(aujZNj[hjF]ubjœ)r¶(}r·((jKUjLj‹jMjNjOjŸjQ}r¸((j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr¹(j¥j¹(ujZNj[hjF]rº((j§)r»(}r¼((jKX*--allow-newer[=pkgs], --allow-older[=pkgs]jLj¶(jMjNjOjªjQ}r½((j¬]r¾((X--allow-newer[r¿(X--allow-older[rÀ(ejV]rÁ(hàajU]jS]jT]jX]rÂ((h8h‚ej²‰ujZMj[hjF]rÃ((j´)rÄ(}rÅ((jKj¿(jLj»(jMjNjOj·jQ}rÆ((j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÇ(jdX--allow-newer[rÈ(…rÉ(}rÊ((jKUjMNjZNj[hjLjÄ(ubaubj½)rË(}rÌ((jKX=pkgs]jLj»(jMjNjOjÀjQ}rÍ((j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÎ(jdX=pkgs]rÏ(…rÐ(}rÑ((jKUjMNjZNj[hjLjË(ubaubj½)rÒ(}rÓ((jKjÄjLj»(jMjNjOjÀjQ}rÔ((j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÕ(jdX, rÖ(…r×(}rØ((jKUjMNjZNj[hjLjÒ(ubaubj´)rÙ(}rÚ((jKjÀ(jLj»(jMjNjOj·jQ}rÛ((j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rÜ(jdX--allow-older[rÝ(…rÞ(}rß((jKUjMNjZNj[hjLjÙ(ubaubj½)rà(}rá((jKX=pkgs]jLj»(jMjNjOjÀjQ}râ((j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rã(jdX=pkgs]rä(…rå(}ræ((jKUjMNjZNj[hjLjà(ubaubeubjØ)rç(}rè((jKUjLj¶(jMjNjOjÛjQ}ré((jS]jT]jU]jV]jX]ujZMj[hjF]rê((j{)rë(}rì((jKXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rí(jLjç(jMjNjOj~jQ}rî((jS]jT]jU]jV]jX]ujZMÉj[hjF]rï(jdXmSelectively relax upper or lower bounds in dependencies without editing the package description respectively.rð(…rñ(}rò((jKjí(jMNjZNj[hjLjë(ubaubj{)ró(}rô((jKXî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.jLjç(jMjNjOj~jQ}rõ((jS]jT]jU]jV]jX]ujZMÌj[hjF]rö((jdX:The following description focuses on upper bounds and the r÷(…rø(}rù((jKX:The following description focuses on upper bounds and the jMNjZNj[hjLjó(ubj¯)rú(}rû((jKX:option:`--allow-newer`rü(jLjó(jMjNjOj³jQ}rý((UreftypeXoptionjµˆj¶X --allow-newerU refdomainXstdrþ(jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÌjF]rÿ(j„)r)}r)(jKjü(jQ}r)(jS]jT]r)(jÀjþ(X std-optionr)ejU]jV]jX]ujLjú(jF]r)jdX --allow-newerr)…r)}r)(jKUjLj)ubajOjŒubaubjdX" flag, but applies analogously to r )…r )}r )(jKX" flag, but applies analogously to jMNjZNj[hjLjó(ubj¯)r )}r )(jKX:option:`--allow-older`r)jLjó(jMjNjOj³jQ}r)(UreftypeXoptionjµˆj¶X --allow-olderU refdomainXstdr)jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÌjF]r)j„)r)}r)(jKj)jQ}r)(jS]jT]r)(jÀj)X std-optionr)ejU]jV]jX]ujLj )jF]r)jdX --allow-olderr)…r)}r)(jKUjLj)ubajOjŒubaubjdX and lower bounds. r)…r)}r)(jKX and lower bounds. jMNjZNj[hjLjó(ubj¯)r)}r)(jKX:option:`--allow-newer`r )jLjó(jMjNjOj³jQ}r!)(UreftypeXoptionjµˆj¶X --allow-newerU refdomainXstdr")jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÌjF]r#)j„)r$)}r%)(jKj )jQ}r&)(jS]jT]r')(jÀj")X std-optionr()ejU]jV]jX]ujLj)jF]r))jdX --allow-newerr*)…r+)}r,)(jKUjLj$)ubajOjŒubaubjdX and r-)…r.)}r/)(jKX and jMNjZNj[hjLjó(ubj¯)r0)}r1)(jKX:option:`--allow-older`r2)jLjó(jMjNjOj³jQ}r3)(UreftypeXoptionjµˆj¶X --allow-olderU refdomainXstdr4)jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMÌjF]r5)j„)r6)}r7)(jKj2)jQ}r8)(jS]jT]r9)(jÀj4)X std-optionr:)ejU]jV]jX]ujLj0)jF]r;)jdX --allow-olderr<)…r=)}r>)(jKUjLj6)ubajOjŒubaubjdX can be used at the same time.r?)…r@)}rA)(jKX can be used at the same time.jMNjZNj[hjLjó(ubeubj{)rB)}rC)(jKXJIf 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.jLjç(jMjNjOj~jQ}rD)(jS]jT]jU]jV]jX]ujZMÑj[hjF]rE)(jdXœ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 rF)…rG)}rH)(jKXœ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 jMNjZNj[hjLjB)ubj„)rI)}rJ)(jKX#``cabal install --allow-newer=B A``jQ}rK)(jS]jT]jU]jV]jX]ujLjB)jF]rL)jdXcabal install --allow-newer=B ArM)…rN)}rO)(jKUjLjI)ubajOjŒubjdX. 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.rP)…rQ)}rR)(jKX‹. 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.jMNjZNj[hjLjB)ubeubj{)rS)}rT)(jKXExample:rU)jLjç(jMjNjOj~jQ}rV)(jS]jT]jU]jV]jX]ujZM×j[hjF]rW)jdXExample:rX)…rY)}rZ)(jKjU)jMNjZNj[hjLjS)ubaubj¸)r[)}r\)(jKX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...jLjç(jMjNjOj»jQ}r])(j¿jÀjV]jU]jS]jT]jX]ujZMÛj[hjF]r^)jdX®$ cd foo $ cabal configure Resolving dependencies... cabal: Could not resolve dependencies: [...] $ cabal configure --allow-newer Resolving dependencies... Configuring foo...r_)…r`)}ra)(jKUjLj[)ubaubj{)rb)}rc)(jKXAdditional examples:rd)jLjç(jMjNjOj~jQ}re)(jS]jT]jU]jV]jX]ujZMäj[hjF]rf)jdXAdditional examples:rg)…rh)}ri)(jKjd)jMNjZNj[hjLjb)ubaubj¸)rj)}rk)(jKX-# 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" foojLjç(jMjNjOj»jQ}rl)(j¿jÀjV]jU]jS]jT]jX]ujZMèj[hjF]rm)jdX-# 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" foorn)…ro)}rp)(jKUjLjj)ubaubj{)rq)}rr)(jKXÚ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``.jLjç(jMjNjOj~jQ}rs)(jS]jT]jU]jV]jX]ujZMñj[hjF]rt)(jdX+It’s also possible to limit the scope of ru)…rv)}rw)(jKX)It's also possible to limit the scope of jMNjZNj[hjLjq)ubj¯)rx)}ry)(jKX:option:`--allow-newer`rz)jLjq)jMjNjOj³jQ}r{)(UreftypeXoptionjµˆj¶X --allow-newerU refdomainXstdr|)jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMñjF]r})j„)r~)}r)(jKjz)jQ}r€)(jS]jT]r)(jÀj|)X std-optionr‚)ejU]jV]jX]ujLjx)jF]rƒ)jdX --allow-newerr„)…r…)}r†)(jKUjLj~)ubajOjŒubaubjdX to single packages with the r‡)…rˆ)}r‰)(jKX to single packages with the jMNjZNj[hjLjq)ubj„)rŠ)}r‹)(jKX``--allow-newer=scope:dep``jQ}rŒ)(jS]jT]jU]jV]jX]ujLjq)jF]r)jdX--allow-newer=scope:deprŽ)…r)}r)(jKUjLjŠ)ubajOjŒubjdX+ syntax. This means that the dependency on r‘)…r’)}r“)(jKX+ syntax. This means that the dependency on jMNjZNj[hjLjq)ubj„)r”)}r•)(jKX``dep``jQ}r–)(jS]jT]jU]jV]jX]ujLjq)jF]r—)jdXdepr˜)…r™)}rš)(jKUjLj”)ubajOjŒubjdX& will be relaxed only for the package r›)…rœ)}r)(jKX& will be relaxed only for the package jMNjZNj[hjLjq)ubj„)rž)}rŸ)(jKX ``scope``jQ}r )(jS]jT]jU]jV]jX]ujLjq)jF]r¡)jdXscoper¢)…r£)}r¤)(jKUjLjž)ubajOjŒubjdX.…r¥)}r¦)(jKX.jMNjZNj[hjLjq)ubeubj{)r§)}r¨)(jKXExample:r©)jLjç(jMjNjOj~jQ}rª)(jS]jT]jU]jV]jX]ujZMöj[hjF]r«)jdXExample:r¬)…r­)}r®)(jKj©)jMNjZNj[hjLj§)ubaubj¸)r¯)}r°)(jKX‚# 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:timejLjç(jMjNjOj»jQ}r±)(j¿jÀjV]jU]jS]jT]jX]ujZMúj[hjF]r²)jdX‚# 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µ)(jKUjLj¯)ubaubj{)r¶)}r·)(jKXì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``).jLjç(jMjNjOj~jQ}r¸)(jS]jT]jU]jV]jX]ujZMj[hjF]r¹)(jdXFinally, one can enable rº)…r»)}r¼)(jKXFinally, one can enable jMNjZNj[hjLj¶)ubj¯)r½)}r¾)(jKX:option:`--allow-newer`r¿)jLj¶)jMjNjOj³jQ}rÀ)(UreftypeXoptionjµˆj¶X --allow-newerU refdomainXstdrÁ)jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj±ujZMjF]rÂ)j„)rÃ)}rÄ)(jKj¿)jQ}rÅ)(jS]jT]rÆ)(jÀjÁ)X std-optionrÇ)ejU]jV]jX]ujLj½)jF]rÈ)jdX --allow-newerrÉ)…rÊ)}rË)(jKUjLjÃ)ubajOjŒubaubjdX permanently by setting rÌ)…rÍ)}rÎ)(jKX permanently by setting jMNjZNj[hjLj¶)ubj„)rÏ)}rÐ)(jKX``allow-newer: True``jQ}rÑ)(jS]jT]jU]jV]jX]ujLj¶)jF]rÒ)jdXallow-newer: TruerÓ)…rÔ)}rÕ)(jKUjLjÏ)ubajOjŒubjdX in the rÖ)…r×)}rØ)(jKX in the jMNjZNj[hjLj¶)ubj„)rÙ)}rÚ)(jKX``~/.cabal/config``jQ}rÛ)(jS]jT]jU]jV]jX]ujLj¶)jF]rÜ)jdX~/.cabal/configrÝ)…rÞ)}rß)(jKUjLjÙ)ubajOjŒubjdXT file. Enabling ‘allow-newer’ selectively is also supported in the config file (rà)…rá)}râ)(jKXP file. Enabling 'allow-newer' selectively is also supported in the config file (jMNjZNj[hjLj¶)ubj„)rã)}rä)(jKX#``allow-newer: foo, bar, baz:base``jQ}rå)(jS]jT]jU]jV]jX]ujLj¶)jF]ræ)jdXallow-newer: foo, bar, baz:baserç)…rè)}ré)(jKUjLjã)ubajOjŒubjdX).rê)…rë)}rì)(jKX).jMNjZNj[hjLj¶)ubeubeubeubj”)rí)}rî)(jKUjLj‹jMNjOj—jQ}rï)(jV]jU]jS]jT]jX]Uentries]rð)(jšX<setup-configure command line option; --constraint=constrainthÆUNtrñ)aujZNj[hjF]ubjœ)rò)}ró)(jKUjLj‹jMNjOjŸjQ}rô)(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrõ)j¥jõ)ujZNj[hjF]rö)(j§)r÷)}rø)(jKX--constraint=constraintjLjò)jMjNjOjªjQ}rù)(j¬]rú)X --constraintrû)ajV]rü)hÆajU]jS]jT]jX]rý)haj²‰ujZM\j[hjF]rþ)(j´)rÿ)}r*(jKjû)jLj÷)jMjNjOj·jQ}r*(j¿jÀjV]jU]jS]jT]jX]ujZM\j[hjF]r*jdX --constraintr*…r*}r*(jKUjMNjZNj[hjLjÿ)ubaubj½)r*}r*(jKX =constraintjLj÷)jMjNjOjÀjQ}r*(j¿jÀjV]jU]jS]jT]jX]ujZM\j[hjF]r *jdX =constraintr *…r *}r *(jKUjMNjZNj[hjLj*ubaubeubjØ)r *}r*(jKUjLjò)jMjNjOjÛjQ}r*(jS]jT]jU]jV]jX]ujZM\j[hjF]r*(j{)r*}r*(jKXÕ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:jLj *jMjNjOj~jQ}r*(jS]jT]jU]jV]jX]ujZM j[hjF]r*(jdX©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*(jKX©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 jMNjZNj[hjLj*ubj„)r*}r*(jKX``bar``jQ}r*(jS]jT]jU]jV]jX]ujLj*jF]r*jdXbarr*…r*}r*(jKUjLj*ubajOjŒubjdX or do not use r*…r *}r!*(jKX or do not use jMNjZNj[hjLj*ubj„)r"*}r#*(jKX``bar``jQ}r$*(jS]jT]jU]jV]jX]ujLj*jF]r%*jdXbarr&*…r'*}r(*(jKUjLj"*ubajOjŒubjdX at all, write:r)*…r**}r+*(jKX at all, write:jMNjZNj[hjLj*ubeubj¸)r,*}r-*(jKX)$ cabal install --constraint="bar == 2.1"jLj *jMjNjOj»jQ}r.*(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r/*jdX)$ cabal install --constraint="bar == 2.1"r0*…r1*}r2*(jKUjLj,*ubaubj{)r3*}r4*(jKXƒVersion bounds have the same syntax as ``build-depends``. As a special case, the following prevents ``bar`` from being used at all:jLj *jMjNjOj~jQ}r5*(jS]jT]jU]jV]jX]ujZMj[hjF]r6*(jdX'Version bounds have the same syntax as r7*…r8*}r9*(jKX'Version bounds have the same syntax as jMNjZNj[hjLj3*ubj„)r:*}r;*(jKX``build-depends``jQ}r<*(jS]jT]jU]jV]jX]ujLj3*jF]r=*jdX build-dependsr>*…r?*}r@*(jKUjLj:*ubajOjŒubjdX,. As a special case, the following prevents rA*…rB*}rC*(jKX,. As a special case, the following prevents jMNjZNj[hjLj3*ubj„)rD*}rE*(jKX``bar``jQ}rF*(jS]jT]jU]jV]jX]ujLj3*jF]rG*jdXbarrH*…rI*}rJ*(jKUjLjD*ubajOjŒubjdX from being used at all:rK*…rL*}rM*(jKX from being used at all:jMNjZNj[hjLj3*ubeubj¸)rN*}rO*(jKX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"jLj *jMjNjOj»jQ}rP*(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rQ*jdX# Note: this is just syntax sugar for '> 1 && < 1', and is # supported by build-depends. $ cabal install --constraint="bar -none"rR*…rS*}rT*(jKUjLjN*ubaubj{)rU*}rV*(jKX&You can also specify flag assignments:rW*jLj *jMjNjOj~jQ}rX*(jS]jT]jU]jV]jX]ujZMj[hjF]rY*jdX&You can also specify flag assignments:rZ*…r[*}r\*(jKjW*jMNjZNj[hjLjU*ubaubj¸)r]*}r^*(jKX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"jLj *jMjNjOj»jQ}r_*(j¿jÀjV]jU]jS]jT]jX]ujZM!j[hjF]r`*jdX…# Require bar to be installed with the foo flag turned on and # the baz flag turned off. $ cabal install --constraint="bar +foo -baz"ra*…rb*}rc*(jKUjLj]*ubaubj{)rd*}re*(jKXWTo specify multiple constraints, you may pass the ``constraint`` option multiple times.jLj *jMjNjOj~jQ}rf*(jS]jT]jU]jV]jX]ujZM%j[hjF]rg*(jdX2To specify multiple constraints, you may pass the rh*…ri*}rj*(jKX2To specify multiple constraints, you may pass the jMNjZNj[hjLjd*ubj„)rk*}rl*(jKX``constraint``jQ}rm*(jS]jT]jU]jV]jX]ujLjd*jF]rn*jdX constraintro*…rp*}rq*(jKUjLjk*ubajOjŒubjdX option multiple times.rr*…rs*}rt*(jKX option multiple times.jMNjZNj[hjLjd*ubeubj{)ru*}rv*(jKXYThere are also some more specialized constraints, which most people don't generally need:rw*jLj *jMjNjOj~jQ}rx*(jS]jT]jU]jV]jX]ujZM(j[hjF]ry*jdX[There are also some more specialized constraints, which most people don’t generally need:rz*…r{*}r|*(jKjw*jMNjZNj[hjLju*ubaubj¸)r}*}r~*(jKXö# 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"jLj *jMjNjOj»jQ}r*(j¿jÀjV]jU]jS]jT]jX]ujZM-j[hjF]r€*jdXö# Require that a version of bar be used that is already installed in # the global package database. $ cabal install --constraint="bar installed" # Require the local source copy of bar to be used. # (Note: By default, if we have a local package we will # automatically use it, so it will generally not be necessary to # specify this.) $ cabal install --constraint="bar source" # Require that bar have test suites and benchmarks enabled. $ cabal install --constraint="bar test" --constraint="bar bench"r*…r‚*}rƒ*(jKUjLj}*ubaubj{)r„*}r…*(jKXÌ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:jLj *jMjNjOj~jQ}r†*(jS]jT]jU]jV]jX]ujZM:j[hjF]r‡*(jdX:By default, constraints only apply to build dependencies (rˆ*…r‰*}rŠ*(jKX:By default, constraints only apply to build dependencies (jMNjZNj[hjLj„*ubj„)r‹*}rŒ*(jKX``build-depends``jQ}r*(jS]jT]jU]jV]jX]ujLj„*jF]rŽ*jdX build-dependsr*…r*}r‘*(jKUjLj‹*ubajOjŒubjdXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the r’*…r“*}r”*(jKXq), build dependencies of build dependencies, and so on. Constraints normally do not apply to dependencies of the jMNjZNj[hjLj„*ubj„)r•*}r–*(jKX ``Setup.hs``jQ}r—*(jS]jT]jU]jV]jX]ujLj„*jF]r˜*jdXSetup.hsr™*…rš*}r›*(jKUjLj•*ubajOjŒubjdX script of any package (rœ*…r*}rž*(jKX script of any package (jMNjZNj[hjLj„*ubj„)rŸ*}r *(jKX``setup-depends``jQ}r¡*(jS]jT]jU]jV]jX]ujLj„*jF]r¢*jdX setup-dependsr£*…r¤*}r¥*(jKUjLjŸ*ubajOjŒubjdX$) nor do they apply to build tools (r¦*…r§*}r¨*(jKX$) nor do they apply to build tools (jMNjZNj[hjLj„*ubj„)r©*}rª*(jKX``build-tool-depends``jQ}r«*(jS]jT]jU]jV]jX]ujLj„*jF]r¬*jdXbuild-tool-dependsr­*…r®*}r¯*(jKUjLj©*ubajOjŒubjdX¡) 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²*(jKX¡) 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:jMNjZNj[hjLj„*ubeubj¸)r³*}r´*(jKXž# Example use of the 'any' qualifier. This constraint # applies to package bar anywhere in the dependency graph. $ cabal install --constraint="any.bar == 1.0"jLj *jMjNjOj»jQ}rµ*(j¿jÀjV]jU]jS]jT]jX]ujZMFj[hjF]r¶*jdXž# 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¹*(jKUjLj³*ubaubj¸)rº*}r»*(jKXP# 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"jLj *jMjNjOj»jQ}r¼*(j¿jÀjV]jU]jS]jT]jX]ujZMLj[hjF]r½*jdXP# 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À*(jKUjLjº*ubaubcdocutils.nodes comment rÁ*)rÂ*}rÃ*(jKXBTODO: Uncomment this example once we decide on a syntax for 'exe'.jLj *jMjNjOUcommentrÄ*jQ}rÅ*(j¿jÀjV]jU]jS]jT]jX]ujZMVj[hjF]rÆ*jdXBTODO: Uncomment this example once we decide on a syntax for 'exe'.rÇ*…rÈ*}rÉ*(jKUjLjÂ*ubaubjÁ*)rÊ*}rË*(jKXï# 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"jLj *jMjNjOjÄ*jQ}rÌ*(j¿jÀjV]jU]jS]jT]jX]ujZM[j[hjF]rÍ*jdXï# 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Ð*(jKUjLjÊ*ubaubeubeubj”)rÑ*}rÒ*(jKUjLj‹jMjNjOj—jQ}rÓ*(jV]jU]jS]jT]jX]Uentries]rÔ*(jšX<setup-configure command line option; --preference=preferencehðUNtrÕ*aujZNj[hjF]ubjœ)rÖ*}r×*(jKUjLj‹jMjNjOjŸjQ}rØ*(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÙ*j¥jÙ*ujZNj[hjF]rÚ*(j§)rÛ*}rÜ*(jKX--preference=preferencejLjÖ*jMjNjOjªjQ}rÝ*(j¬]rÞ*X --preferencerß*ajV]rà*hðajU]jS]jT]jX]rá*hIaj²‰ujZMaj[hjF]râ*(j´)rã*}rä*(jKjß*jLjÛ*jMjNjOj·jQ}rå*(j¿jÀjV]jU]jS]jT]jX]ujZMaj[hjF]ræ*jdX --preferencerç*…rè*}ré*(jKUjMNjZNj[hjLjã*ubaubj½)rê*}rë*(jKX =preferencejLjÛ*jMjNjOjÀjQ}rì*(j¿jÀjV]jU]jS]jT]jX]ujZMaj[hjF]rí*jdX =preferencerî*…rï*}rð*(jKUjMNjZNj[hjLjê*ubaubeubjØ)rñ*}rò*(jKUjLjÖ*jMjNjOjÛjQ}ró*(jS]jT]jU]jV]jX]ujZMaj[hjF]rô*j{)rõ*}rö*(jKX‚Specify a soft constraint on versions of a package. The solver will attempt to satisfy these preferences on a "best-effort" basis.r÷*jLjñ*jMjNjOj~jQ}rø*(jS]jT]jU]jV]jX]ujZM_j[hjF]rù*jdX†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ü*(jKj÷*jMNjZNj[hjLjõ*ubaubaubeubj”)rý*}rþ*(jKUjLj‹jMjNjOj—jQ}rÿ*(jV]jU]jS]jT]jX]Uentries]r+(jšX=setup-configure command line option; --disable-response-filesh¯UNtr+aujZNj[hjF]ubjœ)r+}r+(jKUjLj‹jMjNjOjŸjQ}r+(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr+j¥j+ujZNj[hjF]r+(j§)r+}r+(jKX--disable-response-filesr +jLj+jMjNjOjªjQ}r +(j¬]r +j +ajV]r +h¯ajU]jS]jT]jX]r +haj²‰ujZMjj[hjF]r+(j´)r+}r+(jKj +jLj+jMjNjOj·jQ}r+(j¿jÀjV]jU]jS]jT]jX]ujZMjj[hjF]r+jdX--disable-response-filesr+…r+}r+(jKUjMNjZNj[hjLj+ubaubj½)r+}r+(jKUjLj+jMjNjOjÀjQ}r+(j¿jÀjV]jU]jS]jT]jX]ujZMjj[hjF]ubeubjØ)r+}r+(jKUjLj+jMjNjOjÛjQ}r+(jS]jT]jU]jV]jX]ujZMjj[hjF]r+j{)r+}r+(jKXhEnable 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.jLj+jMjNjOj~jQ}r+(jS]jT]jU]jV]jX]ujZMdj[hjF]r +(jdX9Enable workaround for older versions of programs such as r!+…r"+}r#+(jKX9Enable workaround for older versions of programs such as jMNjZNj[hjLj+ubj„)r$+}r%+(jKX``ar``jQ}r&+(jS]jT]jU]jV]jX]ujLj+jF]r'+jdXarr(+…r)+}r*+(jKUjLj$+ubajOjŒubjdX or r++…r,+}r-+(jKX or jMNjZNj[hjLj+ubj„)r.+}r/+(jKX``ld``jQ}r0+(jS]jT]jU]jV]jX]ujLj+jF]r1+jdXldr2+…r3+}r4+(jKUjLj.+ubajOjŒubjdX3 that do not support response file arguments (i.e. r5+…r6+}r7+(jKX3 that do not support response file arguments (i.e. jMNjZNj[hjLj+ubj„)r8+}r9+(jKX ``@file``jQ}r:+(jS]jT]jU]jV]jX]ujLj+jF]r;+jdX@filer<+…r=+}r>+(jKUjLj8+ubajOjŒubjdXY arguments). You may want this flag only if you specify custom ar executable. For system r?+…r@+}rA+(jKXY arguments). You may want this flag only if you specify custom ar executable. For system jMNjZNj[hjLj+ubj„)rB+}rC+(jKX``ar``jQ}rD+(jS]jT]jU]jV]jX]ujLj+jF]rE+jdXarrF+…rG+}rH+(jKUjLjB+ubajOjŒubjdX or the one bundled with rI+…rJ+}rK+(jKX or the one bundled with jMNjZNj[hjLj+ubj„)rL+}rM+(jKX``ghc``jQ}rN+(jS]jT]jU]jV]jX]ujLj+jF]rO+jdXghcrP+…rQ+}rR+(jKUjLjL+ubajOjŒubjdX on Windows the rS+…rT+}rU+(jKX on Windows the jMNjZNj[hjLj+ubj„)rV+}rW+(jKX ``cabal``jQ}rX+(jS]jT]jU]jV]jX]ujLj+jF]rY+jdXcabalrZ+…r[+}r\+(jKUjLjV+ubajOjŒubjdXK should do the right thing and hence should normally not require this flag.r]+…r^+}r_+(jKXK should do the right thing and hence should normally not require this flag.jMNjZNj[hjLj+ubeubaubeubjã)r`+}ra+(jKX.. _setup-build:jLj‹jMjNjOjæjQ}rb+(jV]jU]jS]jT]jX]jèhÉujZMkj[hjF]ubeubeubjH)rc+}rd+(jKUjLjéjMjNjë}re+h!j`+sjOjPjQ}rf+(jS]jT]jU]jV]rg+(hÉj=ejX]rh+(hœh!eujZMnj[hjð}ri+hÉj`+sjF]rj+(j])rk+}rl+(jKX setup buildrm+jLjc+jMjNjOjajQ}rn+(jS]jT]jU]jV]jX]ujZMnj[hjF]ro+jdX setup buildrp+…rq+}rr+(jKjm+jMNjZNj[hjLjk+ubaubj{)rs+}rt+(jKX\Perform any preprocessing or compilation needed to make this package ready for installation.ru+jLjc+jMjNjOj~jQ}rv+(jS]jT]jU]jV]jX]ujZMpj[hjF]rw+jdX\Perform any preprocessing or compilation needed to make this package ready for installation.rx+…ry+}rz+(jKju+jMNjZNj[hjLjs+ubaubj{)r{+}r|+(jKX)This command takes the following options:r}+jLjc+jMjNjOj~jQ}r~+(jS]jT]jU]jV]jX]ujZMsj[hjF]r+jdX)This command takes the following options:r€+…r+}r‚+(jKj}+jMNjZNj[hjLj{+ubaubj”)rƒ+}r„+(jKUjLjc+jMjNjOj—jQ}r…+(jV]jU]jS]jT]jX]Uentries]r†+(jšXMsetup-build command line option; --prog-options=options, --prog-option=optionh¸UNtr‡+aujZNj[hjF]ubjœ)rˆ+}r‰+(jKUjLjc+jMjNjOjŸjQ}rŠ+(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr‹+j¥j‹+ujZNj[hjF]rŒ+(j§)r+}rŽ+(jKX,--prog-options=options, --prog-option=optionjLjˆ+jMjNjOjªjQ}r+(j¬]r+(X--prog-optionsr‘+X --prog-optionr’+ejV]r“+h¸ajU]jS]jT]jX]r”+(hthej²‰ujZMj[hjF]r•+(j´)r–+}r—+(jKj‘+jLj+jMjNjOj·jQ}r˜+(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r™+jdX--prog-optionsrš+…r›+}rœ+(jKUjMNjZNj[hjLj–+ubaubj½)r+}rž+(jKX=optionsjLj+jMjNjOjÀjQ}rŸ+(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r +jdX=optionsr¡+…r¢+}r£+(jKUjMNjZNj[hjLj+ubaubj½)r¤+}r¥+(jKjÄjLj+jMjNjOjÀjQ}r¦+(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r§+jdX, r¨+…r©+}rª+(jKUjMNjZNj[hjLj¤+ubaubj´)r«+}r¬+(jKj’+jLj+jMjNjOj·jQ}r­+(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r®+jdX --prog-optionr¯+…r°+}r±+(jKUjMNjZNj[hjLj«+ubaubj½)r²+}r³+(jKX=optionjLj+jMjNjOjÀjQ}r´+(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rµ+jdX=optionr¶+…r·+}r¸+(jKUjMNjZNj[hjLj²+ubaubeubjØ)r¹+}rº+(jKUjLjˆ+jMjNjOjÛjQ}r»+(jS]jT]jU]jV]jX]ujZMj[hjF]r¼+j{)r½+}r¾+(jKXiThese 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.jLj¹+jMjNjOj~jQ}r¿+(jS]jT]jU]jV]jX]ujZMyj[hjF]rÀ+(jdX!These are mostly the same as the rÁ+…rÂ+}rÃ+(jKX!These are mostly the same as the jMNjZNj[hjLj½+ubjž)rÄ+}rÅ+(jKX-`options configure step <#setup-configure>`__jQ}rÆ+(UnameXoptions configure stepjìX#setup-configurejV]jU]jS]jT]jX]ujLj½+jF]rÇ+jdXoptions configure steprÈ+…rÉ+}rÊ+(jKUjLjÄ+ubajOj§ubjdX. 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Í+(jKX. 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.jMNjZNj[hjLj½+ubeubaubeubjã)rÎ+}rÏ+(jKX.. _setup-haddock:jLjc+jMjNjOjæjQ}rÐ+(jV]jU]jS]jT]jX]jèh¶ujZM€j[hjF]ubeubjH)rÑ+}rÒ+(jKUjLjéjMjNjë}rÓ+hjÎ+sjOjPjQ}rÔ+(jS]jT]jU]jV]rÕ+(h¶j2ejX]rÖ+(h‘heujZMƒj[hjð}r×+h¶jÎ+sjF]rØ+(j])rÙ+}rÚ+(jKX setup haddockrÛ+jLjÑ+jMjNjOjajQ}rÜ+(jS]jT]jU]jV]jX]ujZMƒj[hjF]rÝ+jdX setup haddockrÞ+…rß+}rà+(jKjÛ+jMNjZNj[hjLjÙ+ubaubj{)rá+}râ+(jKXË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).jLjÑ+jMjNjOj~jQ}rã+(jS]jT]jU]jV]jX]ujZM‡j[hjF]rä+(jdX.Build the documentation for the package using rå+…ræ+}rç+(jKX.Build the documentation for the package using jMNjZNj[hjLjá+ubjž)rè+}ré+(jKXHaddock_jêKjLjá+jOj§jQ}rê+(UnameXHaddockjìXhttp://www.haskell.org/haddock/rë+jV]jU]jS]jT]jX]ujF]rì+jdXHaddockrí+…rî+}rï+(jKUjLjè+ubaubjdXW. By default, only the documentation for the exposed modules is generated (but see the rð+…rñ+}rò+(jKXW. By default, only the documentation for the exposed modules is generated (but see the jMNjZNj[hjLjá+ubj¯)ró+}rô+(jKX:option:`--executables`rõ+jLjá+jMjNjOj³jQ}rö+(UreftypeXoptionjµˆj¶X --executablesU refdomainXstdr÷+jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºX setup-haddockrø+ujZM‡jF]rù+j„)rú+}rû+(jKjõ+jQ}rü+(jS]jT]rý+(jÀj÷+X std-optionrþ+ejU]jV]jX]ujLjó+jF]rÿ+jdX --executablesr,…r,}r,(jKUjLjú+ubajOjŒubaubjdX and r,…r,}r,(jKX and jMNjZNj[hjLjá+ubj¯)r,}r,(jKX:option:`--internal`r,jLjá+jMjNjOj³jQ}r ,(UreftypeXoptionjµˆj¶X --internalU refdomainXstdr ,jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºjø+ujZM‡jF]r ,j„)r ,}r ,(jKj,jQ}r,(jS]jT]r,(jÀj ,X std-optionr,ejU]jV]jX]ujLj,jF]r,jdX --internalr,…r,}r,(jKUjLj ,ubajOjŒubaubjdX flags below).r,…r,}r,(jKX flags below).jMNjZNj[hjLjá+ubeubj{)r,}r,(jKX)This command takes the following options:r,jLjÑ+jMjNjOj~jQ}r,(jS]jT]jU]jV]jX]ujZM‹j[hjF]r,jdX)This command takes the following options:r,…r,}r,(jKj,jMNjZNj[hjLj,ubaubj”)r ,}r!,(jKUjLjÑ+jMjNjOj—jQ}r",(jV]jU]jS]jT]jX]Uentries]r#,(jšX+setup-haddock command line option; --hooglehßUNtr$,aujZNj[hjF]ubjœ)r%,}r&,(jKUjLjÑ+jMjNjOjŸjQ}r',(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr(,j¥j(,ujZNj[hjF]r),(j§)r*,}r+,(jKX--hoogler,,jLj%,jMjNjOjªjQ}r-,(j¬]r.,j,,ajV]r/,hßajU]jS]jT]jX]r0,h7aj²‰ujZM“j[hjF]r1,(j´)r2,}r3,(jKj,,jLj*,jMjNjOj·jQ}r4,(j¿jÀjV]jU]jS]jT]jX]ujZM“j[hjF]r5,jdX--hoogler6,…r7,}r8,(jKUjMNjZNj[hjLj2,ubaubj½)r9,}r:,(jKUjLj*,jMjNjOjÀjQ}r;,(j¿jÀjV]jU]jS]jT]jX]ujZM“j[hjF]ubeubjØ)r<,}r=,(jKUjLj%,jMjNjOjÛjQ}r>,(jS]jT]jU]jV]jX]ujZM“j[hjF]r?,j{)r@,}rA,(jKXº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.jLj<,jMjNjOj~jQ}rB,(jS]jT]jU]jV]jX]ujZMj[hjF]rC,(jdXGenerate a file rD,…rE,}rF,(jKXGenerate a file jMNjZNj[hjLj@,ubj„)rG,}rH,(jKX``dist/doc/html/``jQ}rI,(jS]jT]jU]jV]jX]ujLj@,jF]rJ,jdXdist/doc/html/rK,…rL,}rM,(jKUjLjG,ubajOjŒubjdX…rN,}rO,(jKX\ rP,jMNjZNj[hjLj@,ubj¿)rQ,}rR,(jKX*pkgid*jQ}rS,(jS]jT]jU]jV]jX]ujLj@,jF]rT,jdXpkgidrU,…rV,}rW,(jKUjLjQ,ubajOjÇubjdX…rX,}rY,(jKjP,jLj@,ubj„)rZ,}r[,(jKX``.txt``jQ}r\,(jS]jT]jU]jV]jX]ujLj@,jF]r],jdX.txtr^,…r_,}r`,(jKUjLjZ,ubajOjŒubjdX, which can be converted by ra,…rb,}rc,(jKX, which can be converted by jMNjZNj[hjLj@,ubjž)rd,}re,(jKXHoogle_jêKjLj@,jOj§jQ}rf,(UnameXHooglejìXhttp://www.haskell.org/hoogle/rg,jV]jU]jS]jT]jX]ujF]rh,jdXHoogleri,…rj,}rk,(jKUjLjd,ubaubjdX> into a database for searching. This is equivalent to running rl,…rm,}rn,(jKX> into a database for searching. This is equivalent to running jMNjZNj[hjLj@,ubjž)ro,}rp,(jKXHaddock_jêKjLj@,jOj§jQ}rq,(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]rr,jdXHaddockrs,…rt,}ru,(jKUjLjo,ubaubjdX with the rv,…rw,}rx,(jKX with the jMNjZNj[hjLj@,ubj„)ry,}rz,(jKX ``--hoogle``jQ}r{,(jS]jT]jU]jV]jX]ujLj@,jF]r|,jdX--hoogler},…r~,}r,(jKUjLjy,ubajOjŒubjdX flag.r€,…r,}r‚,(jKX flag.jMNjZNj[hjLj@,ubeubaubeubj”)rƒ,}r„,(jKUjLjÑ+jMjNjOj—jQ}r…,(jV]jU]jS]jT]jX]Uentries]r†,(jšX6setup-haddock command line option; --html-location=urlj"UNtr‡,aujZNj[hjF]ubjœ)rˆ,}r‰,(jKUjLjÑ+jMjNjOjŸjQ}rŠ,(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr‹,j¥j‹,ujZNj[hjF]rŒ,(j§)r,}rŽ,(jKX--html-location=urljLjˆ,jMjNjOjªjQ}r,(j¬]r,X--html-locationr‘,ajV]r’,j"ajU]jS]jT]jX]r“,h~aj²‰ujZM£j[hjF]r”,(j´)r•,}r–,(jKj‘,jLj,jMjNjOj·jQ}r—,(j¿jÀjV]jU]jS]jT]jX]ujZM£j[hjF]r˜,jdX--html-locationr™,…rš,}r›,(jKUjMNjZNj[hjLj•,ubaubj½)rœ,}r,(jKX=urljLj,jMjNjOjÀjQ}rž,(j¿jÀjV]jU]jS]jT]jX]ujZM£j[hjF]rŸ,jdX=urlr ,…r¡,}r¢,(jKUjMNjZNj[hjLjœ,ubaubeubjØ)r£,}r¤,(jKUjLjˆ,jMjNjOjÛjQ}r¥,(jS]jT]jU]jV]jX]ujZM£j[hjF]r¦,(j{)r§,}r¨,(jKXoSpecify 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:jLj£,jMjNjOj~jQ}r©,(jS]jT]jU]jV]jX]ujZM–j[hjF]rª,(jdXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (r«,…r¬,}r­,(jKXhSpecify a template for the location of HTML documentation for prerequisite packages. The substitutions (jMNjZNj[hjLj§,ubjž)r®,}r¯,(jKX3`see listing <#paths-in-the-simple-build-system>`__jQ}r°,(UnameX see listingjìX!#paths-in-the-simple-build-systemjV]jU]jS]jT]jX]ujLj§,jF]r±,jdX see listingr²,…r³,}r´,(jKUjLj®,ubajOj§ubjdXÅ) 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·,(jKXÅ) 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 jMNjZNj[hjLj§,ubjž)r¸,}r¹,(jKXHackage_jêKjLj§,jOj§jQ}rº,(UnameXHackagejìjíjV]jU]jS]jT]jX]ujF]r»,jdXHackager¼,…r½,}r¾,(jKUjLj¸,ubaubjdX pages:r¿,…rÀ,}rÁ,(jKX pages:jMNjZNj[hjLj§,ubeubcdocutils.nodes block_quote rÂ,)rÃ,}rÄ,(jKUjLj£,jMjNjOU block_quoterÅ,jQ}rÆ,(jS]jT]jU]jV]jX]ujZNj[hjF]rÇ,j{)rÈ,}rÉ,(jKX`setup haddock --html-location='http://hackage.haskell.org/packages/archive/$pkg/latest/doc/html'jLjÃ,jMjNjOj~jQ}rÊ,(jS]jT]jU]jV]jX]ujZMjF]rË,(jdX"setup haddock –html-location=’rÌ,…rÍ,}rÎ,(jKXsetup haddock --html-location='jLjÈ,ubjž)rÏ,}rÐ,(jKX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlrÑ,jQ}rÒ,(UrefurijÑ,jV]jU]jS]jT]jX]ujLjÈ,jF]rÓ,jdX@http://hackage.haskell.org/packages/archive/$pkg/latest/doc/htmlrÔ,…rÕ,}rÖ,(jKUjLjÏ,ubajOj§ubjdX’…r×,}rØ,(jKX'jLjÈ,ubeubaubj{)rÙ,}rÚ,(jKX±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``).jLj£,jMjNjOj~jQ}rÛ,(jS]jT]jU]jV]jX]ujZM j[hjF]rÜ,(jdX¤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ß,(jKX¤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. jMNjZNj[hjLjÙ,ubj„)rà,}rá,(jKX ``ghc-pkg``jQ}râ,(jS]jT]jU]jV]jX]ujLjÙ,jF]rã,jdXghc-pkgrä,…rå,}ræ,(jKUjLjà,ubajOjŒubjdX).rç,…rè,}ré,(jKX).jMNjZNj[hjLjÙ,ubeubeubeubj”)rê,}rë,(jKUjLjÑ+jMjNjOj—jQ}rì,(jV]jU]jS]jT]jX]Uentries]rí,(jšX0setup-haddock command line option; --executablesj9UNtrî,aujZNj[hjF]ubjœ)rï,}rð,(jKUjLjÑ+jMjNjOjŸjQ}rñ,(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrò,j¥jò,ujZNj[hjF]ró,(j§)rô,}rõ,(jKX --executablesrö,jLjï,jMjNjOjªjQ}r÷,(j¬]rø,jö,ajV]rù,j9ajU]jS]jT]jX]rú,h˜aj²‰ujZM¨j[hjF]rû,(j´)rü,}rý,(jKjö,jLjô,jMjNjOj·jQ}rþ,(j¿jÀjV]jU]jS]jT]jX]ujZM¨j[hjF]rÿ,jdX --executablesr-…r-}r-(jKUjMNjZNj[hjLjü,ubaubj½)r-}r-(jKUjLjô,jMjNjOjÀjQ}r-(j¿jÀjV]jU]jS]jT]jX]ujZM¨j[hjF]ubeubjØ)r-}r-(jKUjLjï,jMjNjOjÛjQ}r-(jS]jT]jU]jV]jX]ujZM¨j[hjF]r -j{)r -}r -(jKXzAlso run Haddock_ for the modules of all the executable programs. By default Haddock_ is run only on the exported modules.jLj-jMjNjOj~jQ}r -(jS]jT]jU]jV]jX]ujZM¦j[hjF]r -(jdX Also run r-…r-}r-(jKX Also run jMNjZNj[hjLj -ubjž)r-}r-(jKXHaddock_jêKjLj -jOj§jQ}r-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]r-jdXHaddockr-…r-}r-(jKUjLj-ubaubjdX< for the modules of all the executable programs. By default r-…r-}r-(jKX< for the modules of all the executable programs. By default jMNjZNj[hjLj -ubjž)r-}r-(jKXHaddock_jêKjLj -jOj§jQ}r-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]r-jdXHaddockr-…r -}r!-(jKUjLj-ubaubjdX% is run only on the exported modules.r"-…r#-}r$-(jKX% is run only on the exported modules.jMNjZNj[hjLj -ubeubaubeubj”)r%-}r&-(jKUjLjÑ+jMjNjOj—jQ}r'-(jV]jU]jS]jT]jX]Uentries]r(-(jšX-setup-haddock command line option; --internalhØUNtr)-aujZNj[hjF]ubjœ)r*-}r+-(jKUjLjÑ+jMjNjOjŸjQ}r,-(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr--j¥j--ujZNj[hjF]r.-(j§)r/-}r0-(jKX --internalr1-jLj*-jMjNjOjªjQ}r2-(j¬]r3-j1-ajV]r4-hØajU]jS]jT]jX]r5-h0aj²‰ujZM¯j[hjF]r6-(j´)r7-}r8-(jKj1-jLj/-jMjNjOj·jQ}r9-(j¿jÀjV]jU]jS]jT]jX]ujZM¯j[hjF]r:-jdX --internalr;-…r<-}r=-(jKUjMNjZNj[hjLj7-ubaubj½)r>-}r?-(jKUjLj/-jMjNjOjÀjQ}r@-(j¿jÀjV]jU]jS]jT]jX]ujZM¯j[hjF]ubeubjØ)rA-}rB-(jKUjLj*-jMjNjOjÛjQ}rC-(jS]jT]jU]jV]jX]ujZM¯j[hjF]rD-j{)rE-}rF-(jKX„Run Haddock_ for the all modules, including unexposed ones, and make Haddock_ generate documentation for unexported symbols as well.jLjA-jMjNjOj~jQ}rG-(jS]jT]jU]jV]jX]ujZM«j[hjF]rH-(jdXRun rI-…rJ-}rK-(jKXRun jMNjZNj[hjLjE-ubjž)rL-}rM-(jKXHaddock_jêKjLjE-jOj§jQ}rN-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]rO-jdXHaddockrP-…rQ-}rR-(jKUjLjL-ubaubjdX9 for the all modules, including unexposed ones, and make rS-…rT-}rU-(jKX9 for the all modules, including unexposed ones, and make jMNjZNj[hjLjE-ubjž)rV-}rW-(jKXHaddock_jêKjLjE-jOj§jQ}rX-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]rY-jdXHaddockrZ-…r[-}r\-(jKUjLjV-ubaubjdX7 generate documentation for unexported symbols as well.r]-…r^-}r_-(jKX7 generate documentation for unexported symbols as well.jMNjZNj[hjLjE-ubeubaubeubj”)r`-}ra-(jKUjLjÑ+jMjNjOj—jQ}rb-(jV]jU]jS]jT]jX]Uentries]rc-(jšX-setup-haddock command line option; --css=pathhîUNtrd-aujZNj[hjF]ubjœ)re-}rf-(jKUjLjÑ+jMjNjOjŸjQ}rg-(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrh-j¥jh-ujZNj[hjF]ri-(j§)rj-}rk-(jKX --css=pathjLje-jMjNjOjªjQ}rl-(j¬]rm-X--cssrn-ajV]ro-hîajU]jS]jT]jX]rp-hGaj²‰ujZM·j[hjF]rq-(j´)rr-}rs-(jKjn-jLjj-jMjNjOj·jQ}rt-(j¿jÀjV]jU]jS]jT]jX]ujZM·j[hjF]ru-jdX--cssrv-…rw-}rx-(jKUjMNjZNj[hjLjr-ubaubj½)ry-}rz-(jKX=pathjLjj-jMjNjOjÀjQ}r{-(j¿jÀjV]jU]jS]jT]jX]ujZM·j[hjF]r|-jdX=pathr}-…r~-}r-(jKUjMNjZNj[hjLjy-ubaubeubjØ)r€-}r-(jKUjLje-jMjNjOjÛjQ}r‚-(jS]jT]jU]jV]jX]ujZM·j[hjF]rƒ-j{)r„-}r…-(jKXÃ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.jLj€-jMjNjOj~jQ}r†-(jS]jT]jU]jV]jX]ujZM²j[hjF]r‡-(jdX The argument rˆ-…r‰-}rŠ-(jKX The argument jMNjZNj[hjLj„-ubj¿)r‹-}rŒ-(jKX*path*jQ}r-(jS]jT]jU]jV]jX]ujLj„-jF]rŽ-jdXpathr-…r-}r‘-(jKUjLj‹-ubajOjÇubjdX( denotes a CSS file, which is passed to r’-…r“-}r”-(jKX( denotes a CSS file, which is passed to jMNjZNj[hjLj„-ubjž)r•-}r–-(jKXHaddock_jêKjLj„-jOj§jQ}r—-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]r˜-jdXHaddockr™-…rš-}r›-(jKUjLj•-ubaubjdXr and used to set the style of the generated documentation. This is only needed to override the default style that rœ-…r-}rž-(jKXr and used to set the style of the generated documentation. This is only needed to override the default style that jMNjZNj[hjLj„-ubjž)rŸ-}r -(jKXHaddock_jêKjLj„-jOj§jQ}r¡-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]r¢-jdXHaddockr£-…r¤-}r¥-(jKUjLjŸ-ubaubjdX uses.r¦-…r§-}r¨-(jKX uses.jMNjZNj[hjLj„-ubeubaubeubj”)r©-}rª-(jKUjLjÑ+jMjNjOj—jQ}r«-(jV]jU]jS]jT]jX]Uentries]r¬-(jšX5setup-haddock command line option; --hyperlink-sourcej&UNtr­-aujZNj[hjF]ubjœ)r®-}r¯-(jKUjLjÑ+jMjNjOjŸjQ}r°-(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr±-j¥j±-ujZNj[hjF]r²-(j§)r³-}r´-(jKX--hyperlink-sourcerµ-jLj®-jMjNjOjªjQ}r¶-(j¬]r·-jµ-ajV]r¸-j&ajU]jS]jT]jX]r¹-h„aj²‰ujZM¾j[hjF]rº-(j´)r»-}r¼-(jKjµ-jLj³-jMjNjOj·jQ}r½-(j¿jÀjV]jU]jS]jT]jX]ujZM¾j[hjF]r¾-jdX--hyperlink-sourcer¿-…rÀ-}rÁ-(jKUjMNjZNj[hjLj»-ubaubj½)rÂ-}rÃ-(jKUjLj³-jMjNjOjÀjQ}rÄ-(j¿jÀjV]jU]jS]jT]jX]ujZM¾j[hjF]ubeubjØ)rÅ-}rÆ-(jKUjLj®-jMjNjOjÛjQ}rÇ-(jS]jT]jU]jV]jX]ujZM¾j[hjF]rÈ-j{)rÉ-}rÊ-(jKXGenerate 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.jLjÅ-jMjNjOj~jQ}rË-(jS]jT]jU]jV]jX]ujZMºj[hjF]rÌ-(jdX Generate rÍ-…rÎ-}rÏ-(jKX Generate jMNjZNj[hjLjÉ-ubjž)rÐ-}rÑ-(jKXHaddock_jêKjLjÉ-jOj§jQ}rÒ-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]rÓ-jdXHaddockrÔ-…rÕ-}rÖ-(jKUjLjÐ-ubaubjdX documentation integrated with r×-…rØ-}rÙ-(jKX documentation integrated with jMNjZNj[hjLjÉ-ubjž)rÚ-}rÛ-(jKX HsColour_jêKjLjÉ-jOj§jQ}rÜ-(UnameXHsColourjìX+http://www.cs.york.ac.uk/fp/darcs/hscolour/rÝ-jV]jU]jS]jT]jX]ujF]rÞ-jdXHsColourrß-…rà-}rá-(jKUjLjÚ-ubaubjdX . First, râ-…rã-}rä-(jKX . First, jMNjZNj[hjLjÉ-ubjž)rå-}ræ-(jKX HsColour_jêKjLjÉ-jOj§jQ}rç-(UnameXHsColourjìjÝ-jV]jU]jS]jT]jX]ujF]rè-jdXHsColourré-…rê-}rë-(jKUjLjå-ubaubjdX* is run to generate colourised code. Then rì-…rí-}rî-(jKX* is run to generate colourised code. Then jMNjZNj[hjLjÉ-ubjž)rï-}rð-(jKXHaddock_jêKjLjÉ-jOj§jQ}rñ-(UnameXHaddockjìjë+jV]jU]jS]jT]jX]ujF]rò-jdXHaddockró-…rô-}rõ-(jKUjLjï-ubaubjdX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.rö-…r÷-}rø-(jKX‚ is run to generate HTML documentation. Each entity shown in the documentation is linked to its definition in the colourised code.jMNjZNj[hjLjÉ-ubeubaubeubj”)rù-}rú-(jKUjLjÑ+jMjNjOj—jQ}rû-(jV]jU]jS]jT]jX]Uentries]rü-(jšX6setup-haddock command line option; --hscolour-css=pathhûUNtrý-aujZNj[hjF]ubjœ)rþ-}rÿ-(jKUjLjÑ+jMjNjOjŸjQ}r.(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr.j¥j.ujZNj[hjF]r.(j§)r.}r.(jKX--hscolour-css=pathr.jLjþ-jMjNjOjªjQ}r.(j¬]r.X--hscolour-cssr.ajV]r .hûajU]jS]jT]jX]r .hTaj²‰ujZMÄj[hjF]r .(j´)r .}r .(jKj.jLj.jMjNjOj·jQ}r.(j¿jÀjV]jU]jS]jT]jX]ujZMÄj[hjF]r.jdX--hscolour-cssr.…r.}r.(jKUjMNjZNj[hjLj .ubaubj½)r.}r.(jKX=pathjLj.jMjNjOjÀjQ}r.(j¿jÀjV]jU]jS]jT]jX]ujZMÄj[hjF]r.jdX=pathr.…r.}r.(jKUjMNjZNj[hjLj.ubaubeubjØ)r.}r.(jKUjLjþ-jMjNjOjÛjQ}r.(jS]jT]jU]jV]jX]ujZMÄj[hjF]r.(j{)r.}r.(jKXJThe argument *path* denotes a CSS file, which is passed to HsColour_ as inr .jLj.jMjNjOj~jQ}r!.(jS]jT]jU]jV]jX]ujZMÁj[hjF]r".(jdX The argument r#.…r$.}r%.(jKX The argument jMNjZNj[hjLj.ubj¿)r&.}r'.(jKX*path*jQ}r(.(jS]jT]jU]jV]jX]ujLj.jF]r).jdXpathr*.…r+.}r,.(jKUjLj&.ubajOjÇubjdX( denotes a CSS file, which is passed to r-.…r..}r/.(jKX( denotes a CSS file, which is passed to jMNjZNj[hjLj.ubjž)r0.}r1.(jKX HsColour_jêKjLj.jOj§jQ}r2.(UnameXHsColourjìjÝ-jV]jU]jS]jT]jX]ujF]r3.jdXHsColourr4.…r5.}r6.(jKUjLj0.ubaubjdX as inr7.…r8.}r9.(jKX as injMNjZNj[hjLj.ubeubjÂ,)r:.}r;.(jKUjLj.jMjNjOjÅ,jQ}r<.(jS]jT]jU]jV]jX]ujZNj[hjF]r=.j{)r>.}r?.(jKX)runhaskell Setup.hs hscolour --css=*path*r@.jLj:.jMjNjOj~jQ}rA.(jS]jT]jU]jV]jX]ujZMÃjF]rB.jdX*runhaskell Setup.hs hscolour –css=*path*rC.…rD.}rE.(jKj@.jLj>.ubaubaubeubeubjã)rF.}rG.(jKX.. _setup-hscolour:jLjÑ+jMjNjOjæjQ}rH.(jV]jU]jS]jT]jX]jèj5ujZMÅj[hjF]ubeubjH)rI.}rJ.(jKUjLjéjMjNjë}rK.h”jF.sjOjPjQ}rL.(jS]jT]jU]jV]rM.(j5j$ejX]rN.(h€h”eujZMÈj[hjð}rO.j5jF.sjF]rP.(j])rQ.}rR.(jKXsetup hscolourrS.jLjI.jMjNjOjajQ}rT.(jS]jT]jU]jV]jX]ujZMÈj[hjF]rU.jdXsetup hscolourrV.…rW.}rX.(jKjS.jMNjZNj[hjLjQ.ubaubj{)rY.}rZ.(jKXProduce colourised code in HTML format using HsColour_. Colourised code for exported modules is put in ``dist/doc/html/``\ *pkgid*\ ``/src``.jLjI.jMjNjOj~jQ}r[.(jS]jT]jU]jV]jX]ujZMÊj[hjF]r\.(jdX-Produce colourised code in HTML format using r].…r^.}r_.(jKX-Produce colourised code in HTML format using jMNjZNj[hjLjY.ubjž)r`.}ra.(jKX HsColour_jêKjLjY.jOj§jQ}rb.(UnameXHsColourjìjÝ-jV]jU]jS]jT]jX]ujF]rc.jdXHsColourrd.…re.}rf.(jKUjLj`.ubaubjdX1. Colourised code for exported modules is put in rg.…rh.}ri.(jKX1. Colourised code for exported modules is put in jMNjZNj[hjLjY.ubj„)rj.}rk.(jKX``dist/doc/html/``jQ}rl.(jS]jT]jU]jV]jX]ujLjY.jF]rm.jdXdist/doc/html/rn.…ro.}rp.(jKUjLjj.ubajOjŒubjdX…rq.}rr.(jKX\ rs.jMNjZNj[hjLjY.ubj¿)rt.}ru.(jKX*pkgid*jQ}rv.(jS]jT]jU]jV]jX]ujLjY.jF]rw.jdXpkgidrx.…ry.}rz.(jKUjLjt.ubajOjÇubjdX…r{.}r|.(jKjs.jLjY.ubj„)r}.}r~.(jKX``/src``jQ}r.(jS]jT]jU]jV]jX]ujLjY.jF]r€.jdX/srcr.…r‚.}rƒ.(jKUjLj}.ubajOjŒubjdX.…r„.}r….(jKX.jMNjZNj[hjLjY.ubeubj{)r†.}r‡.(jKX)This command takes the following options:rˆ.jLjI.jMjNjOj~jQ}r‰.(jS]jT]jU]jV]jX]ujZMÍj[hjF]rŠ.jdX)This command takes the following options:r‹.…rŒ.}r.(jKjˆ.jMNjZNj[hjLj†.ubaubj”)rŽ.}r.(jKUjLjI.jMjNjOj—jQ}r.(jV]jU]jS]jT]jX]Uentries]r‘.(jšX1setup-hscolour command line option; --executablesjUNtr’.aujZNj[hjF]ubjœ)r“.}r”.(jKUjLjI.jMjNjOjŸjQ}r•.(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr–.j¥j–.ujZNj[hjF]r—.(j§)r˜.}r™.(jKX --executablesrš.jLj“.jMjNjOjªjQ}r›.(j¬]rœ.jš.ajV]r.jajU]jS]jT]jX]rž.hvaj²‰ujZMÕj[hjF]rŸ.(j´)r .}r¡.(jKjš.jLj˜.jMjNjOj·jQ}r¢.(j¿jÀjV]jU]jS]jT]jX]ujZMÕj[hjF]r£.jdX --executablesr¤.…r¥.}r¦.(jKUjMNjZNj[hjLj .ubaubj½)r§.}r¨.(jKUjLj˜.jMjNjOjÀjQ}r©.(j¿jÀjV]jU]jS]jT]jX]ujZMÕj[hjF]ubeubjØ)rª.}r«.(jKUjLj“.jMjNjOjÛjQ}r¬.(jS]jT]jU]jV]jX]ujZMÕj[hjF]r­.j{)r®.}r¯.(jKX‹Also run HsColour_ on the sources of all executable programs. Colourised code is put in ``dist/doc/html/``\ *pkgid*/*executable*\ ``/src``.jLjª.jMjNjOj~jQ}r°.(jS]jT]jU]jV]jX]ujZMÓj[hjF]r±.(jdX Also run r².…r³.}r´.(jKX Also run jMNjZNj[hjLj®.ubjž)rµ.}r¶.(jKX HsColour_jêKjLj®.jOj§jQ}r·.(UnameXHsColourjìjÝ-jV]jU]jS]jT]jX]ujF]r¸.jdXHsColourr¹.…rº.}r».(jKUjLjµ.ubaubjdXF on the sources of all executable programs. Colourised code is put in r¼.…r½.}r¾.(jKXF on the sources of all executable programs. Colourised code is put in jMNjZNj[hjLj®.ubj„)r¿.}rÀ.(jKX``dist/doc/html/``jQ}rÁ.(jS]jT]jU]jV]jX]ujLj®.jF]rÂ.jdXdist/doc/html/rÃ.…rÄ.}rÅ.(jKUjLj¿.ubajOjŒubjdX…rÆ.}rÇ.(jKX\ rÈ.jMNjZNj[hjLj®.ubj¿)rÉ.}rÊ.(jKX*pkgid*jQ}rË.(jS]jT]jU]jV]jX]ujLj®.jF]rÌ.jdXpkgidrÍ.…rÎ.}rÏ.(jKUjLjÉ.ubajOjÇubjdX/…rÐ.}rÑ.(jKX/jMNjZNj[hjLj®.ubj¿)rÒ.}rÓ.(jKX *executable*jQ}rÔ.(jS]jT]jU]jV]jX]ujLj®.jF]rÕ.jdX executablerÖ.…r×.}rØ.(jKUjLjÒ.ubajOjÇubjdX…rÙ.}rÚ.(jKjÈ.jLj®.ubj„)rÛ.}rÜ.(jKX``/src``jQ}rÝ.(jS]jT]jU]jV]jX]ujLj®.jF]rÞ.jdX/srcrß.…rà.}rá.(jKUjLjÛ.ubajOjŒubjdX.…râ.}rã.(jKX.jMNjZNj[hjLj®.ubeubaubeubj”)rä.}rå.(jKUjLjI.jMjNjOj—jQ}ræ.(jV]jU]jS]jT]jX]Uentries]rç.(jšX.setup-hscolour command line option; --css=pathh»UNtrè.aujZNj[hjF]ubjœ)ré.}rê.(jKUjLjI.jMjNjOjŸjQ}rë.(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrì.j¥jì.ujZNj[hjF]rí.(j§)rî.}rï.(jKX --css=pathjLjé.jMjNjOjªjQ}rð.(j¬]rñ.X--cssrò.ajV]ró.h»ajU]jS]jT]jX]rô.haj²‰ujZMÜj[hjF]rõ.(j´)rö.}r÷.(jKjò.jLjî.jMjNjOj·jQ}rø.(j¿jÀjV]jU]jS]jT]jX]ujZMÜj[hjF]rù.jdX--cssrú.…rû.}rü.(jKUjMNjZNj[hjLjö.ubaubj½)rý.}rþ.(jKX=pathjLjî.jMjNjOjÀjQ}rÿ.(j¿jÀjV]jU]jS]jT]jX]ujZMÜj[hjF]r/jdX=pathr/…r/}r/(jKUjMNjZNj[hjLjý.ubaubeubjØ)r/}r/(jKUjLjé.jMjNjOjÛjQ}r/(jS]jT]jU]jV]jX]ujZMÜj[hjF]r/j{)r/}r /(jKXþ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.jLj/jMjNjOj~jQ}r /(jS]jT]jU]jV]jX]ujZMØj[hjF]r /(jdXÒ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/(jKXÒ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 jMNjZNj[hjLj/ubj„)r/}r/(jKX``hscolour.css``jQ}r/(jS]jT]jU]jV]jX]ujLj/jF]r/jdX hscolour.cssr/…r/}r/(jKUjLj/ubajOjŒubjdX) rather than linking to it.r/…r/}r/(jKX) rather than linking to it.jMNjZNj[hjLj/ubeubaubeubjã)r/}r/(jKX.. _setup-install:jLjI.jMjNjOjæjQ}r/(jV]jU]jS]jT]jX]jèhåujZMÝj[hjF]ubeubjH)r/}r/(jKUjLjéjMjNjë}r/h=j/sjOjPjQ}r/(jS]jT]jU]jV]r /(håhëejX]r!/(hDh=eujZMàj[hjð}r"/håj/sjF]r#/(j])r$/}r%/(jKX setup installr&/jLj/jMjNjOjajQ}r'/(jS]jT]jU]jV]jX]ujZMàj[hjF]r(/jdX setup installr)/…r*/}r+/(jKj&/jMNjZNj[hjLj$/ubaubj{)r,/}r-/(jKX¥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./jLj/jMjNjOj~jQ}r//(jS]jT]jU]jV]jX]ujZMäj[hjF]r0/jdX¥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.r1/…r2/}r3/(jKj./jMNjZNj[hjLj,/ubaubj{)r4/}r5/(jKX`The `install locations <#installation-paths>`__ are determined by options to `setup configure`_.jLj/jMjNjOj~jQ}r6/(jS]jT]jU]jV]jX]ujZMèj[hjF]r7/(jdXThe r8/…r9/}r:/(jKXThe jMNjZNj[hjLj4/ubjž)r;/}r`__jQ}r=/(UnameXinstall locationsjìX#installation-pathsjV]jU]jS]jT]jX]ujLj4/jF]r>/jdXinstall locationsr?/…r@/}rA/(jKUjLj;/ubajOj§ubjdX are determined by options to rB/…rC/}rD/(jKX are determined by options to jMNjZNj[hjLj4/ubjž)rE/}rF/(jKX`setup configure`_jêKjLj4/jOj§jQ}rG/(UnameXsetup configurejV]jU]jS]jT]jX]jèj'ujF]rH/jdXsetup configurerI/…rJ/}rK/(jKUjLjE/ubaubjdX.…rL/}rM/(jKX.jMNjZNj[hjLj4/ubeubj{)rN/}rO/(jKX)This command takes the following options:rP/jLj/jMjNjOj~jQ}rQ/(jS]jT]jU]jV]jX]ujZMëj[hjF]rR/jdX)This command takes the following options:rS/…rT/}rU/(jKjP/jMNjZNj[hjLjN/ubaubj”)rV/}rW/(jKUjLj/jMjNjOj—jQ}rX/(jV]jU]jS]jT]jX]Uentries]rY/(jšX+setup-install command line option; --globaljUNtrZ/aujZNj[hjF]ubjœ)r[/}r\/(jKUjLj/jMjNjOjŸjQ}r]/(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr^/j¥j^/ujZNj[hjF]r_/(j§)r`/}ra/(jKX--globalrb/jLj[/jMjNjOjªjQ}rc/(j¬]rd/jb/ajV]re/jajU]jS]jT]jX]rf/h^aj²‰ujZMòj[hjF]rg/(j´)rh/}ri/(jKjb/jLj`/jMjNjOj·jQ}rj/(j¿jÀjV]jU]jS]jT]jX]ujZMòj[hjF]rk/jdX--globalrl/…rm/}rn/(jKUjMNjZNj[hjLjh/ubaubj½)ro/}rp/(jKUjLj`/jMjNjOjÀjQ}rq/(j¿jÀjV]jU]jS]jT]jX]ujZMòj[hjF]ubeubjØ)rr/}rs/(jKUjLj[/jMjNjOjÛjQ}rt/(jS]jT]jU]jV]jX]ujZMòj[hjF]ru/j{)rv/}rw/(jKX§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.)jLjr/jMjNjOj~jQ}rx/(jS]jT]jU]jV]jX]ujZMïj[hjF]ry/(jdXTRegister this package in the system-wide database. (This is the default, unless the rz/…r{/}r|/(jKXTRegister this package in the system-wide database. (This is the default, unless the jMNjZNj[hjLjv/ubj¯)r}/}r~/(jKX :option:`setup configure --user`r/jLjv/jMjNjOj³jQ}r€/(UreftypeXoptionjµˆj¶Xsetup configure --userU refdomainXstdr/jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºX setup-installr‚/ujZMïjF]rƒ/j„)r„/}r…/(jKj/jQ}r†/(jS]jT]r‡/(jÀj/X std-optionrˆ/ejU]jV]jX]ujLj}/jF]r‰/jdXsetup configure --userrŠ/…r‹/}rŒ/(jKUjLj„/ubajOjŒubaubjdX option was supplied to the r/…rŽ/}r/(jKX option was supplied to the jMNjZNj[hjLjv/ubj„)r/}r‘/(jKX ``configure``jQ}r’/(jS]jT]jU]jV]jX]ujLjv/jF]r“/jdX configurer”/…r•/}r–/(jKUjLj/ubajOjŒubjdX command.)r—/…r˜/}r™/(jKX command.)jMNjZNj[hjLjv/ubeubaubeubj”)rš/}r›/(jKUjLj/jMjNjOj—jQ}rœ/(jV]jU]jS]jT]jX]Uentries]r/(jšX)setup-install command line option; --userjUNtrž/aujZNj[hjF]ubjœ)rŸ/}r /(jKUjLj/jMjNjOjŸjQ}r¡/(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr¢/j¥j¢/ujZNj[hjF]r£/(j§)r¤/}r¥/(jKX--userr¦/jLjŸ/jMjNjOjªjQ}r§/(j¬]r¨/j¦/ajV]r©/jajU]jS]jT]jX]rª/hlaj²‰ujZMøj[hjF]r«/(j´)r¬/}r­/(jKj¦/jLj¤/jMjNjOj·jQ}r®/(j¿jÀjV]jU]jS]jT]jX]ujZMøj[hjF]r¯/jdX--userr°/…r±/}r²/(jKUjMNjZNj[hjLj¬/ubaubj½)r³/}r´/(jKUjLj¤/jMjNjOjÀjQ}rµ/(j¿jÀjV]jU]jS]jT]jX]ujZMøj[hjF]ubeubjØ)r¶/}r·/(jKUjLjŸ/jMjNjOjÛjQ}r¸/(jS]jT]jU]jV]jX]ujZMøj[hjF]r¹/j{)rº/}r»/(jKX«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.)jLj¶/jMjNjOj~jQ}r¼/(jS]jT]jU]jV]jX]ujZMõj[hjF]r½/(jdXZRegister this package in the user’s local package database. (This is the default if the r¾/…r¿/}rÀ/(jKXXRegister this package in the user's local package database. (This is the default if the jMNjZNj[hjLjº/ubj¯)rÁ/}rÂ/(jKX :option:`setup configure --user`rÃ/jLjº/jMjNjOj³jQ}rÄ/(UreftypeXoptionjµˆj¶Xsetup configure --userU refdomainXstdrÅ/jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºj‚/ujZMõjF]rÆ/j„)rÇ/}rÈ/(jKjÃ/jQ}rÉ/(jS]jT]rÊ/(jÀjÅ/X std-optionrË/ejU]jV]jX]ujLjÁ/jF]rÌ/jdXsetup configure --userrÍ/…rÎ/}rÏ/(jKUjLjÇ/ubajOjŒubaubjdX option was supplied to the rÐ/…rÑ/}rÒ/(jKX option was supplied to the jMNjZNj[hjLjº/ubj„)rÓ/}rÔ/(jKX ``configure``jQ}rÕ/(jS]jT]jU]jV]jX]ujLjº/jF]rÖ/jdX configurer×/…rØ/}rÙ/(jKUjLjÓ/ubajOjŒubjdX command.)rÚ/…rÛ/}rÜ/(jKX command.)jMNjZNj[hjLjº/ubeubaubeubjã)rÝ/}rÞ/(jKX.. _setup-copy:jLj/jMjNjOjæjQ}rß/(jV]jU]jS]jT]jX]jèjBujZMùj[hjF]ubeubjH)rà/}rá/(jKUjLjéjMjNjë}râ/h¡jÝ/sjOjPjQ}rã/(jS]jT]jU]jV]rä/(jBj,ejX]rå/(hŠh¡eujZMüj[hjð}ræ/jBjÝ/sjF]rç/(j])rè/}ré/(jKX setup copyrê/jLjà/jMjNjOjajQ}rë/(jS]jT]jU]jV]jX]ujZMüj[hjF]rì/jdX setup copyrí/…rî/}rï/(jKjê/jMNjZNj[hjLjè/ubaubj{)rð/}rñ/(jKXiCopy the files without registering them. This command is mainly of use to those creating binary packages.rò/jLjà/jMjNjOj~jQ}ró/(jS]jT]jU]jV]jX]ujZMþj[hjF]rô/jdXiCopy the files without registering them. This command is mainly of use to those creating binary packages.rõ/…rö/}r÷/(jKjò/jMNjZNj[hjLjð/ubaubj{)rø/}rù/(jKX(This command takes the following option:rú/jLjà/jMjNjOj~jQ}rû/(jS]jT]jU]jV]jX]ujZMj[hjF]rü/jdX(This command takes the following option:rý/…rþ/}rÿ/(jKjú/jMNjZNj[hjLjø/ubaubj”)r0}r0(jKUjLjà/jMjNjOj—jQ}r0(jV]jU]jS]jT]jX]Uentries]r0(jšX.setup-copy command line option; --destdir=pathhïUNtr0aujZNj[hjF]ubjœ)r0}r0(jKUjLjà/jMjNjOjŸjQ}r0(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr0j¥j0ujZNj[hjF]r 0(j§)r 0}r 0(jKX--destdir=pathjLj0jMjNjOjªjQ}r 0(j¬]r 0X --destdirr0ajV]r0hïajU]jS]jT]jX]r0hHaj²‰ujZM j[hjF]r0(j´)r0}r0(jKj0jLj 0jMjNjOj·jQ}r0(j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r0jdX --destdirr0…r0}r0(jKUjMNjZNj[hjLj0ubaubj½)r0}r0(jKX=pathjLj 0jMjNjOjÀjQ}r0(j¿jÀjV]jU]jS]jT]jX]ujZM j[hjF]r0jdX=pathr0…r0}r0(jKUjMNjZNj[hjLj0ubaubeubjØ)r 0}r!0(jKUjLj0jMjNjOjÛjQ}r"0(jS]jT]jU]jV]jX]ujZM j[hjF]r#0j{)r$0}r%0(jKXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r&0jLj 0jMjNjOj~jQ}r'0(jS]jT]jU]jV]jX]ujZMj[hjF]r(0jdXuSpecify the directory under which to place installed files. If this is not given, then the root directory is assumed.r)0…r*0}r+0(jKj&0jMNjZNj[hjLj$0ubaubaubeubjã)r,0}r-0(jKX.. _setup-register:jLjà/jMjNjOjæjQ}r.0(jV]jU]jS]jT]jX]jèjujZM j[hjF]ubeubjH)r/0}r00(jKUjLjéjMjNjë}r10h\j,0sjOjPjQ}r20(jS]jT]jU]jV]r30(jhËejX]r40(h#h\eujZM j[hjð}r50jj,0sjF]r60(j])r70}r80(jKXsetup registerr90jLj/0jMjNjOjajQ}r:0(jS]jT]jU]jV]jX]ujZM j[hjF]r;0jdXsetup registerr<0…r=0}r>0(jKj90jMNjZNj[hjLj70ubaubj{)r?0}r@0(jKX&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.jLj/0jMjNjOj~jQ}rA0(jS]jT]jU]jV]jX]ujZMj[hjF]rB0(jdXœ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 rC0…rD0}rE0(jKXœ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 jMNjZNj[hjLj?0ubj„)rF0}rG0(jKX ``install``jQ}rH0(jS]jT]jU]jV]jX]ujLj?0jF]rI0jdXinstallrJ0…rK0}rL0(jKUjLjF0ubajOjŒubjdX command incorporates this action. The main use of this separate command is in the post-installation step for a binary package.rM0…rN0}rO0(jKX command incorporates this action. The main use of this separate command is in the post-installation step for a binary package.jMNjZNj[hjLj?0ubeubj{)rP0}rQ0(jKX)This command takes the following options:rR0jLj/0jMjNjOj~jQ}rS0(jS]jT]jU]jV]jX]ujZMj[hjF]rT0jdX)This command takes the following options:rU0…rV0}rW0(jKjR0jMNjZNj[hjLjP0ubaubj”)rX0}rY0(jKUjLj/0jMjNjOj—jQ}rZ0(jV]jU]jS]jT]jX]Uentries]r[0(jšX,setup-register command line option; --globalj*UNtr\0aujZNj[hjF]ubjœ)r]0}r^0(jKUjLj/0jMjNjOjŸjQ}r_0(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr`0j¥j`0ujZNj[hjF]ra0(j§)rb0}rc0(jKX--globalrd0jLj]0jMjNjOjªjQ}re0(j¬]rf0jd0ajV]rg0j*ajU]jS]jT]jX]rh0hˆaj²‰ujZMj[hjF]ri0(j´)rj0}rk0(jKjd0jLjb0jMjNjOj·jQ}rl0(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]rm0jdX--globalrn0…ro0}rp0(jKUjMNjZNj[hjLjj0ubaubj½)rq0}rr0(jKUjLjb0jMjNjOjÀjQ}rs0(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]ubeubjØ)rt0}ru0(jKUjLj]0jMjNjOjÛjQ}rv0(jS]jT]jU]jV]jX]ujZMj[hjF]rw0j{)rx0}ry0(jKXIRegister this package in the system-wide database. (This is the default.)rz0jLjt0jMjNjOj~jQ}r{0(jS]jT]jU]jV]jX]ujZMj[hjF]r|0jdXIRegister this package in the system-wide database. (This is the default.)r}0…r~0}r0(jKjz0jMNjZNj[hjLjx0ubaubaubeubj”)r€0}r0(jKUjLj/0jMjNjOj—jQ}r‚0(jV]jU]jS]jT]jX]Uentries]rƒ0(jšX*setup-register command line option; --userjUNtr„0aujZNj[hjF]ubjœ)r…0}r†0(jKUjLj/0jMjNjOjŸjQ}r‡0(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrˆ0j¥jˆ0ujZNj[hjF]r‰0(j§)rŠ0}r‹0(jKX--userrŒ0jLj…0jMjNjOjªjQ}r0(j¬]rŽ0jŒ0ajV]r0jajU]jS]jT]jX]r0hraj²‰ujZM!j[hjF]r‘0(j´)r’0}r“0(jKjŒ0jLjŠ0jMjNjOj·jQ}r”0(j¿jÀjV]jU]jS]jT]jX]ujZM!j[hjF]r•0jdX--userr–0…r—0}r˜0(jKUjMNjZNj[hjLj’0ubaubj½)r™0}rš0(jKUjLjŠ0jMjNjOjÀjQ}r›0(j¿jÀjV]jU]jS]jT]jX]ujZM!j[hjF]ubeubjØ)rœ0}r0(jKUjLj…0jMjNjOjÛjQ}rž0(jS]jT]jU]jV]jX]ujZM!j[hjF]rŸ0j{)r 0}r¡0(jKX;Register this package in the user's local package database.r¢0jLjœ0jMjNjOj~jQ}r£0(jS]jT]jU]jV]jX]ujZM j[hjF]r¤0jdX=Register this package in the user’s local package database.r¥0…r¦0}r§0(jKj¢0jMNjZNj[hjLj 0ubaubaubeubj”)r¨0}r©0(jKUjLj/0jMjNjOj—jQ}rª0(jV]jU]jS]jT]jX]Uentries]r«0(jšX0setup-register command line option; --gen-scriptj(UNtr¬0aujZNj[hjF]ubjœ)r­0}r®0(jKUjLj/0jMjNjOjŸjQ}r¯0(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr°0j¥j°0ujZNj[hjF]r±0(j§)r²0}r³0(jKX --gen-scriptr´0jLj­0jMjNjOjªjQ}rµ0(j¬]r¶0j´0ajV]r·0j(ajU]jS]jT]jX]r¸0h†aj²‰ujZM)j[hjF]r¹0(j´)rº0}r»0(jKj´0jLj²0jMjNjOj·jQ}r¼0(j¿jÀjV]jU]jS]jT]jX]ujZM)j[hjF]r½0jdX --gen-scriptr¾0…r¿0}rÀ0(jKUjMNjZNj[hjLjº0ubaubj½)rÁ0}rÂ0(jKUjLj²0jMjNjOjÀjQ}rÃ0(j¿jÀjV]jU]jS]jT]jX]ujZM)j[hjF]ubeubjØ)rÄ0}rÅ0(jKUjLj­0jMjNjOjÛjQ}rÆ0(jS]jT]jU]jV]jX]ujZM)j[hjF]rÇ0j{)rÈ0}rÉ0(jKX!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.jLjÄ0jMjNjOj~jQ}rÊ0(jS]jT]jU]jV]jX]ujZM$j[hjF]rË0(jdX„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(jKX„Instead of registering the package, generate a script containing commands to perform the registration. On Unix, this file is called jMNjZNj[hjLjÈ0ubj„)rÏ0}rÐ0(jKX``register.sh``jQ}rÑ0(jS]jT]jU]jV]jX]ujLjÈ0jF]rÒ0jdX register.shrÓ0…rÔ0}rÕ0(jKUjLjÏ0ubajOjŒubjdX, on Windows, rÖ0…r×0}rØ0(jKX, on Windows, jMNjZNj[hjLjÈ0ubj„)rÙ0}rÚ0(jKX``register.bat``jQ}rÛ0(jS]jT]jU]jV]jX]ujLjÈ0jF]rÜ0jdX register.batrÝ0…rÞ0}rß0(jKUjLjÙ0ubajOjŒubjdXp. 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(jKXp. This script might be included in a binary bundle, to be run after the bundle is unpacked on the target system.jMNjZNj[hjLjÈ0ubeubaubeubj”)rã0}rä0(jKUjLj/0jMjNjOj—jQ}rå0(jV]jU]jS]jT]jX]Uentries]ræ0(jšX;setup-register command line option; --gen-pkg-config[=path]hÿUNtrç0aujZNj[hjF]ubjœ)rè0}ré0(jKUjLj/0jMjNjOjŸjQ}rê0(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrë0j¥jë0ujZNj[hjF]rì0(j§)rí0}rî0(jKX--gen-pkg-config[=path]jLjè0jMjNjOjªjQ}rï0(j¬]rð0X--gen-pkg-config[rñ0ajV]rò0hÿajU]jS]jT]jX]ró0hXaj²‰ujZM;j[hjF]rô0(j´)rõ0}rö0(jKjñ0jLjí0jMjNjOj·jQ}r÷0(j¿jÀjV]jU]jS]jT]jX]ujZM;j[hjF]rø0jdX--gen-pkg-config[rù0…rú0}rû0(jKUjMNjZNj[hjLjõ0ubaubj½)rü0}rý0(jKX=path]jLjí0jMjNjOjÀjQ}rþ0(j¿jÀjV]jU]jS]jT]jX]ujZM;j[hjF]rÿ0jdX=path]r1…r1}r1(jKUjMNjZNj[hjLjü0ubaubeubjØ)r1}r1(jKUjLjè0jMjNjOjÛjQ}r1(jS]jT]jU]jV]jX]ujZM;j[hjF]r1(j{)r1}r1(jKX„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.jLj1jMjNjOj~jQ}r 1(jS]jT]jU]jV]jX]ujZM,j[hjF]r 1(jdXtInstead 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 1…r 1}r 1(jKXrInstead 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 jMNjZNj[hjLj1ubj¯)r1}r1(jKX:option:`--gen-script`r1jLj1jMjNjOj³jQ}r1(UreftypeXoptionjµˆj¶X --gen-scriptU refdomainXstdr1jV]jU]U refexplicit‰jS]jT]jX]j¸j¹jºXsetup-registerr1ujZM,jF]r1j„)r1}r1(jKj1jQ}r1(jS]jT]r1(jÀj1X std-optionr1ejU]jV]jX]ujLj1jF]r1jdX --gen-scriptr1…r1}r1(jKUjLj1ubajOjŒubaubjdXN option instead since it is more portable across Haskell implementations. The r1…r1}r 1(jKXN option instead since it is more portable across Haskell implementations. The jMNjZNj[hjLj1ubj¿)r!1}r"1(jKX*path*jQ}r#1(jS]jT]jU]jV]jX]ujLj1jF]r$1jdXpathr%1…r&1}r'1(jKUjLj!1ubajOjÇubjdX” 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}r*1(jKX” 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 jMNjZNj[hjLj1ubj„)r+1}r,1(jKX ``.conf``jQ}r-1(jS]jT]jU]jV]jX]ujLj1jF]r.1jdX.confr/1…r01}r11(jKUjLj+1ubajOjŒubjdX extension.r21…r31}r41(jKX extension.jMNjZNj[hjLj1ubeubj{)r51}r61(jKXÝ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.r71jLj1jMjNjOj~jQ}r81(jS]jT]jU]jV]jX]ujZM7j[hjF]r91jdXÝThis option outputs a directory if the package requires multiple registrations: this can occur if internal/convenience libraries are used. These configuration file names are sorted so that they can be registered in order.r:1…r;1}r<1(jKj71jMNjZNj[hjLj51ubaubeubeubj”)r=1}r>1(jKUjLj/0jMjNjOj—jQ}r?1(jV]jU]jS]jT]jX]Uentries]r@1(jšX-setup-register command line option; --inplacejUNtrA1aujZNj[hjF]ubjœ)rB1}rC1(jKUjLj/0jMjNjOjŸjQ}rD1(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrE1j¥jE1ujZNj[hjF]rF1(j§)rG1}rH1(jKX --inplacerI1jLjB1jMjNjOjªjQ}rJ1(j¬]rK1jI1ajV]rL1jajU]jS]jT]jX]rM1huaj²‰ujZMJj[hjF]rN1(j´)rO1}rP1(jKjI1jLjG1jMjNjOj·jQ}rQ1(j¿jÀjV]jU]jS]jT]jX]ujZMJj[hjF]rR1jdX --inplacerS1…rT1}rU1(jKUjMNjZNj[hjLjO1ubaubj½)rV1}rW1(jKUjLjG1jMjNjOjÀjQ}rX1(j¿jÀjV]jU]jS]jT]jX]ujZMJj[hjF]ubeubjØ)rY1}rZ1(jKUjLjB1jMjNjOjÛjQ}r[1(jS]jT]jU]jV]jX]ujZMJj[hjF]r\1(j{)r]1}r^1(jKXÎ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.r_1jLjY1jMjNjOj~jQ}r`1(jS]jT]jU]jV]jX]ujZM>j[hjF]ra1jdXÐ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.rb1…rc1}rd1(jKj_1jMNjZNj[hjLj]1ubaubj{)re1}rf1(jKX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.rg1jLjY1jMjNjOj~jQ}rh1(jS]jT]jU]jV]jX]ujZMCj[hjF]ri1jdX…This flag does not create a build-tree-local package database. It still registers the package in one of the user or global databases.rj1…rk1}rl1(jKjg1jMNjZNj[hjLje1ubaubj{)rm1}rn1(jKXÈ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.ro1jLjY1jMjNjOj~jQ}rp1(jS]jT]jU]jV]jX]ujZMFj[hjF]rq1jdXÊ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.rr1…rs1}rt1(jKjo1jMNjZNj[hjLjm1ubaubeubeubjã)ru1}rv1(jKX.. _setup-unregister:jLj/0jMjNjOjæjQ}rw1(jV]jU]jS]jT]jX]jèh±ujZMKj[hjF]ubeubjH)rx1}ry1(jKUjLjéjMjNjë}rz1h ju1sjOjPjQ}r{1(jS]jT]jU]jV]r|1(h±j-ejX]r}1(h‹h eujZMNj[hjð}r~1h±ju1sjF]r1(j])r€1}r1(jKXsetup unregisterr‚1jLjx1jMjNjOjajQ}rƒ1(jS]jT]jU]jV]jX]ujZMNj[hjF]r„1jdXsetup unregisterr…1…r†1}r‡1(jKj‚1jMNjZNj[hjLj€1ubaubj{)rˆ1}r‰1(jKX*Deregister this package with the compiler.rŠ1jLjx1jMjNjOj~jQ}r‹1(jS]jT]jU]jV]jX]ujZMRj[hjF]rŒ1jdX*Deregister this package with the compiler.r1…rŽ1}r1(jKjŠ1jMNjZNj[hjLjˆ1ubaubj{)r1}r‘1(jKX)This command takes the following options:r’1jLjx1jMjNjOj~jQ}r“1(jS]jT]jU]jV]jX]ujZMTj[hjF]r”1jdX)This command takes the following options:r•1…r–1}r—1(jKj’1jMNjZNj[hjLj1ubaubj”)r˜1}r™1(jKUjLjx1jMjNjOj—jQ}rš1(jV]jU]jS]jT]jX]Uentries]r›1(jšX.setup-unregister command line option; --globaljUNtrœ1aujZNj[hjF]ubjœ)r1}rž1(jKUjLjx1jMjNjOjŸjQ}rŸ1(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr 1j¥j 1ujZNj[hjF]r¡1(j§)r¢1}r£1(jKX--globalr¤1jLj1jMjNjOjªjQ}r¥1(j¬]r¦1j¤1ajV]r§1jajU]jS]jT]jX]r¨1hYaj²‰ujZMZj[hjF]r©1(j´)rª1}r«1(jKj¤1jLj¢1jMjNjOj·jQ}r¬1(j¿jÀjV]jU]jS]jT]jX]ujZMZj[hjF]r­1jdX--globalr®1…r¯1}r°1(jKUjMNjZNj[hjLjª1ubaubj½)r±1}r²1(jKUjLj¢1jMjNjOjÀjQ}r³1(j¿jÀjV]jU]jS]jT]jX]ujZMZj[hjF]ubeubjØ)r´1}rµ1(jKUjLj1jMjNjOjÛjQ}r¶1(jS]jT]jU]jV]jX]ujZMZj[hjF]r·1j{)r¸1}r¹1(jKXKDeregister this package in the system-wide database. (This is the default.)rº1jLj´1jMjNjOj~jQ}r»1(jS]jT]jU]jV]jX]ujZMXj[hjF]r¼1jdXKDeregister this package in the system-wide database. (This is the default.)r½1…r¾1}r¿1(jKjº1jMNjZNj[hjLj¸1ubaubaubeubj”)rÀ1}rÁ1(jKUjLjx1jMjNjOj—jQ}rÂ1(jV]jU]jS]jT]jX]Uentries]rÃ1(jšX,setup-unregister command line option; --userh¿UNtrÄ1aujZNj[hjF]ubjœ)rÅ1}rÆ1(jKUjLjx1jMjNjOjŸjQ}rÇ1(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÈ1j¥jÈ1ujZNj[hjF]rÉ1(j§)rÊ1}rË1(jKX--userrÌ1jLjÅ1jMjNjOjªjQ}rÍ1(j¬]rÎ1jÌ1ajV]rÏ1h¿ajU]jS]jT]jX]rÐ1haj²‰ujZM^j[hjF]rÑ1(j´)rÒ1}rÓ1(jKjÌ1jLjÊ1jMjNjOj·jQ}rÔ1(j¿jÀjV]jU]jS]jT]jX]ujZM^j[hjF]rÕ1jdX--userrÖ1…r×1}rØ1(jKUjMNjZNj[hjLjÒ1ubaubj½)rÙ1}rÚ1(jKUjLjÊ1jMjNjOjÀjQ}rÛ1(j¿jÀjV]jU]jS]jT]jX]ujZM^j[hjF]ubeubjØ)rÜ1}rÝ1(jKUjLjÅ1jMjNjOjÛjQ}rÞ1(jS]jT]jU]jV]jX]ujZM^j[hjF]rß1j{)rà1}rá1(jKX=Deregister this package in the user's local package database.râ1jLjÜ1jMjNjOj~jQ}rã1(jS]jT]jU]jV]jX]ujZM]j[hjF]rä1jdX?Deregister this package in the user’s local package database.rå1…ræ1}rç1(jKjâ1jMNjZNj[hjLjà1ubaubaubeubj”)rè1}ré1(jKUjLjx1jMjNjOj—jQ}rê1(jV]jU]jS]jT]jX]Uentries]rë1(jšX2setup-unregister command line option; --gen-scripthèUNtrì1aujZNj[hjF]ubjœ)rí1}rî1(jKUjLjx1jMjNjOjŸjQ}rï1(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrð1j¥jð1ujZNj[hjF]rñ1(j§)rò1}ró1(jKX --gen-scriptrô1jLjí1jMjNjOjªjQ}rõ1(j¬]rö1jô1ajV]r÷1hèajU]jS]jT]jX]rø1h@aj²‰ujZMej[hjF]rù1(j´)rú1}rû1(jKjô1jLjò1jMjNjOj·jQ}rü1(j¿jÀjV]jU]jS]jT]jX]ujZMej[hjF]rý1jdX --gen-scriptrþ1…rÿ1}r2(jKUjMNjZNj[hjLjú1ubaubj½)r2}r2(jKUjLjò1jMjNjOjÀjQ}r2(j¿jÀjV]jU]jS]jT]jX]ujZMej[hjF]ubeubjØ)r2}r2(jKUjLjí1jMjNjOjÛjQ}r2(jS]jT]jU]jV]jX]ujZMej[hjF]r2j{)r2}r 2(jKX 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.jLj2jMjNjOj~jQ}r 2(jS]jT]jU]jV]jX]ujZMaj[hjF]r 2(jdXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called r 2…r 2}r2(jKXˆInstead of deregistering the package, generate a script containing commands to perform the deregistration. On Unix, this file is called jMNjZNj[hjLj2ubj„)r2}r2(jKX``unregister.sh``jQ}r2(jS]jT]jU]jV]jX]ujLj2jF]r2jdX unregister.shr2…r2}r2(jKUjLj2ubajOjŒubjdX, on Windows, r2…r2}r2(jKX, on Windows, jMNjZNj[hjLj2ubj„)r2}r2(jKX``unregister.bat``jQ}r2(jS]jT]jU]jV]jX]ujLj2jF]r2jdXunregister.batr2…r2}r2(jKUjLj2ubajOjŒubjdXS. This script might be included in a binary bundle, to be run on the target system.r 2…r!2}r"2(jKXS. This script might be included in a binary bundle, to be run on the target system.jMNjZNj[hjLj2ubeubaubeubjã)r#2}r$2(jKX.. _setup-clean:jLjx1jMjNjOjæjQ}r%2(jV]jU]jS]jT]jX]jèhµujZMfj[hjF]ubeubjH)r&2}r'2(jKUjLjéjMjNjë}r(2h j#2sjOjPjQ}r)2(jS]jT]jU]jV]r*2(hµj ejX]r+2(hdh eujZMij[hjð}r,2hµj#2sjF]r-2(j])r.2}r/2(jKX setup cleanr02jLj&2jMjNjOjajQ}r12(jS]jT]jU]jV]jX]ujZMij[hjF]r22jdX setup cleanr32…r42}r52(jKj02jMNjZNj[hjLj.2ubaubj{)r62}r72(jKXË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.jLj&2jMjNjOj~jQ}r82(jS]jT]jU]jV]jX]ujZMkj[hjF]r92(jdX*Remove any local files created during the r:2…r;2}r<2(jKX*Remove any local files created during the jMNjZNj[hjLj62ubj„)r=2}r>2(jKX ``configure``jQ}r?2(jS]jT]jU]jV]jX]ujLj62jF]r@2jdX configurerA2…rB2}rC2(jKUjLj=2ubajOjŒubjdX, rD2…rE2}rF2(jKX, rG2jMNjZNj[hjLj62ubj„)rH2}rI2(jKX ``build``jQ}rJ2(jS]jT]jU]jV]jX]ujLj62jF]rK2jdXbuildrL2…rM2}rN2(jKUjLjH2ubajOjŒubjdX, rO2…rP2}rQ2(jKX, jMNjZNj[hjLj62ubj„)rR2}rS2(jKX ``haddock``jQ}rT2(jS]jT]jU]jV]jX]ujLj62jF]rU2jdXhaddockrV2…rW2}rX2(jKUjLjR2ubajOjŒubjdX, rY2…rZ2}r[2(jKjG2jLj62ubj„)r\2}r]2(jKX ``register``jQ}r^2(jS]jT]jU]jV]jX]ujLj62jF]r_2jdXregisterr`2…ra2}rb2(jKUjLj\2ubajOjŒubjdX or rc2…rd2}re2(jKX or jMNjZNj[hjLj62ubj„)rf2}rg2(jKX``unregister``jQ}rh2(jS]jT]jU]jV]jX]ujLj62jF]ri2jdX unregisterrj2…rk2}rl2(jKUjLjf2ubajOjŒubjdX9 steps, and also any files and directories listed in the rm2…rn2}ro2(jKX9 steps, and also any files and directories listed in the jMNjZNj[hjLj62ubj¯)rp2}rq2(jKX:pkg-field:`extra-tmp-files`rr2jLj62jMjNjOj³jQ}rs2(UreftypeX pkg-fieldjµˆj¶Xextra-tmp-filesU refdomainXcabalrt2jV]jU]U refexplicit‰jS]jT]jX]j¸j¹Ucabal:pkg-sectionru2NujZMkjF]rv2j„)rw2}rx2(jKjr2jQ}ry2(jS]jT]rz2(jÀjt2Xcabal-pkg-fieldr{2ejU]jV]jX]ujLjp2jF]r|2jdXextra-tmp-filesr}2…r~2}r2(jKUjLjw2ubajOjŒubaubjdX field.r€2…r2}r‚2(jKX field.jMNjZNj[hjLj62ubeubj{)rƒ2}r„2(jKX)This command takes the following options:r…2jLj&2jMjNjOj~jQ}r†2(jS]jT]jU]jV]jX]ujZMoj[hjF]r‡2jdX)This command takes the following options:rˆ2…r‰2}rŠ2(jKj…2jMNjZNj[hjLjƒ2ubaubj”)r‹2}rŒ2(jKUjLj&2jMjNjOj—jQ}r2(jV]jU]jS]jT]jX]Uentries]rŽ2(jšX5setup-clean command line option; --save-configure, -shÈUNtr2aujZNj[hjF]ubjœ)r2}r‘2(jKUjLj&2jMjNjOjŸjQ}r’2(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr“2j¥j“2ujZNj[hjF]r”2(j§)r•2}r–2(jKX--save-configure, -sjLj2jMjNjOjªjQ}r—2(j¬]r˜2(X--save-configurer™2X-srš2ejV]r›2hÈajU]jS]jT]jX]rœ2(hjh ej²‰ujZMwj[hjF]r2(j´)rž2}rŸ2(jKj™2jLj•2jMjNjOj·jQ}r 2(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]r¡2jdX--save-configurer¢2…r£2}r¤2(jKUjMNjZNj[hjLjž2ubaubj½)r¥2}r¦2(jKUjLj•2jMjNjOjÀjQ}r§2(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]ubj½)r¨2}r©2(jKjÄjLj•2jMjNjOjÀjQ}rª2(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]r«2jdX, r¬2…r­2}r®2(jKUjMNjZNj[hjLj¨2ubaubj´)r¯2}r°2(jKjš2jLj•2jMjNjOj·jQ}r±2(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]r²2jdX-sr³2…r´2}rµ2(jKUjMNjZNj[hjLj¯2ubaubj½)r¶2}r·2(jKUjLj•2jMjNjOjÀjQ}r¸2(j¿jÀjV]jU]jS]jT]jX]ujZMwj[hjF]ubeubjØ)r¹2}rº2(jKUjLj2jMjNjOjÛjQ}r»2(jS]jT]jU]jV]jX]ujZMwj[hjF]r¼2j{)r½2}r¾2(jKXkKeeps the configuration information so it is not necessary to run the configure step again before building.r¿2jLj¹2jMjNjOj~jQ}rÀ2(jS]jT]jU]jV]jX]ujZMuj[hjF]rÁ2jdXkKeeps the configuration information so it is not necessary to run the configure step again before building.rÂ2…rÃ2}rÄ2(jKj¿2jMNjZNj[hjLj½2ubaubaubeubeubjH)rÅ2}rÆ2(jKUjLjéjMjNjOjPjQ}rÇ2(jS]jT]jU]jV]rÈ2hýajX]rÉ2hVaujZMyj[hjF]rÊ2(j])rË2}rÌ2(jKX setup testrÍ2jLjÅ2jMjNjOjajQ}rÎ2(jS]jT]jU]jV]jX]ujZMyj[hjF]rÏ2jdX setup testrÐ2…rÑ2}rÒ2(jKjÍ2jMNjZNj[hjLjË2ubaubj{)rÓ2}rÔ2(jKX(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.jLjÅ2jMjNjOj~jQ}rÕ2(jS]jT]jU]jV]jX]ujZM{j[hjF]rÖ2(jdX«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(jKX«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 jMNjZNj[hjLjÓ2ubj„)rÚ2}rÛ2(jKX``test``jQ}rÜ2(jS]jT]jU]jV]jX]ujLjÓ2jF]rÝ2jdXtestrÞ2…rß2}rà2(jKUjLjÚ2ubajOjŒubjdXu. 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(jKXu. When supplied, Cabal will run only the named test suites, otherwise, Cabal will run all test suites in the package.jMNjZNj[hjLjÓ2ubeubj”)rä2}rå2(jKUjLjÅ2jMjNjOj—jQ}ræ2(jV]jU]jS]jT]jX]Uentries]rç2(jšX.setup-test command line option; --builddir=dirhñUNtrè2aujZNj[hjF]ubjœ)ré2}rê2(jKUjLjÅ2jMjNjOjŸjQ}rë2(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrì2j¥jì2ujZNj[hjF]rí2(j§)rî2}rï2(jKX--builddir=dirjLjé2jMjNjOjªjQ}rð2(j¬]rñ2X --builddirrò2ajV]ró2hñajU]jS]jT]jX]rô2hJaj²‰ujZM‡j[hjF]rõ2(j´)rö2}r÷2(jKjò2jLjî2jMjNjOj·jQ}rø2(j¿jÀjV]jU]jS]jT]jX]ujZM‡j[hjF]rù2jdX --builddirrú2…rû2}rü2(jKUjMNjZNj[hjLjö2ubaubj½)rý2}rþ2(jKX=dirjLjî2jMjNjOjÀjQ}rÿ2(j¿jÀjV]jU]jS]jT]jX]ujZM‡j[hjF]r3jdX=dirr3…r3}r3(jKUjMNjZNj[hjLjý2ubaubeubjØ)r3}r3(jKUjLjé2jMjNjOjÛjQ}r3(jS]jT]jU]jV]jX]ujZM‡j[hjF]r3j{)r3}r 3(jKXThe directory where Cabal puts generated build files (default: ``dist``). Test logs will be located in the ``test`` subdirectory.jLj3jMjNjOj~jQ}r 3(jS]jT]jU]jV]jX]ujZM…j[hjF]r 3(jdX?The directory where Cabal puts generated build files (default: r 3…r 3}r3(jKX?The directory where Cabal puts generated build files (default: jMNjZNj[hjLj3ubj„)r3}r3(jKX``dist``jQ}r3(jS]jT]jU]jV]jX]ujLj3jF]r3jdXdistr3…r3}r3(jKUjLj3ubajOjŒubjdX$). Test logs will be located in the r3…r3}r3(jKX$). Test logs will be located in the jMNjZNj[hjLj3ubj„)r3}r3(jKX``test``jQ}r3(jS]jT]jU]jV]jX]ujLj3jF]r3jdXtestr3…r3}r3(jKUjLj3ubajOjŒubjdX subdirectory.r 3…r!3}r"3(jKX subdirectory.jMNjZNj[hjLj3ubeubaubeubj”)r#3}r$3(jKUjLjÅ2jMjNjOj—jQ}r%3(jV]jU]jS]jT]jX]Uentries]r&3(jšX0setup-test command line option; --human-log=pathh´UNtr'3aujZNj[hjF]ubjœ)r(3}r)3(jKUjLjÅ2jMjNjOjŸjQ}r*3(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr+3j¥j+3ujZNj[hjF]r,3(j§)r-3}r.3(jKX--human-log=pathjLj(3jMjNjOjªjQ}r/3(j¬]r03X --human-logr13ajV]r23h´ajU]jS]jT]jX]r33h aj²‰ujZMj[hjF]r43(j´)r53}r63(jKj13jLj-3jMjNjOj·jQ}r73(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r83jdX --human-logr93…r:3}r;3(jKUjMNjZNj[hjLj53ubaubj½)r<3}r=3(jKX=pathjLj-3jMjNjOjÀjQ}r>3(j¿jÀjV]jU]jS]jT]jX]ujZMj[hjF]r?3jdX=pathr@3…rA3}rB3(jKUjMNjZNj[hjLj<3ubaubeubjØ)rC3}rD3(jKUjLj(3jMjNjOjÛjQ}rE3(jS]jT]jU]jV]jX]ujZMj[hjF]rF3j{)rG3}rH3(jKX~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``.jLjC3jMjNjOj~jQ}rI3(jS]jT]jU]jV]jX]ujZMŠj[hjF]rJ3(jdXLThe template used to name human-readable test logs; the path is relative to rK3…rL3}rM3(jKXLThe template used to name human-readable test logs; the path is relative to jMNjZNj[hjLjG3ubj„)rN3}rO3(jKX ``dist/test``jQ}rP3(jS]jT]jU]jV]jX]ujLjG3jF]rQ3jdX dist/testrR3…rS3}rT3(jKUjLjN3ubajOjŒubjdX7. By default, logs are named according to the template rU3…rV3}rW3(jKX7. By default, logs are named according to the template jMNjZNj[hjLjG3ubj„)rX3}rY3(jKX``$pkgid-$test-suite.log``jQ}rZ3(jS]jT]jU]jV]jX]ujLjG3jF]r[3jdX$pkgid-$test-suite.logr\3…r]3}r^3(jKUjLjX3ubajOjŒubjdXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: r_3…r`3}ra3(jKXm, so that each test suite will be logged to its own human-readable log file. Template variables allowed are: jMNjZNj[hjLjG3ubj„)rb3}rc3(jKX ``$pkgid``jQ}rd3(jS]jT]jU]jV]jX]ujLjG3jF]re3jdX$pkgidrf3…rg3}rh3(jKUjLjb3ubajOjŒubjdX, ri3…rj3}rk3(jKX, rl3jMNjZNj[hjLjG3ubj„)rm3}rn3(jKX ``$compiler``jQ}ro3(jS]jT]jU]jV]jX]ujLjG3jF]rp3jdX $compilerrq3…rr3}rs3(jKUjLjm3ubajOjŒubjdX, rt3…ru3}rv3(jKX, jLjG3ubj„)rw3}rx3(jKX``$os``jQ}ry3(jS]jT]jU]jV]jX]ujLjG3jF]rz3jdX$osr{3…r|3}r}3(jKUjLjw3ubajOjŒubjdX, r~3…r3}r€3(jKX, jMNjZNj[hjLjG3ubj„)r3}r‚3(jKX ``$arch``jQ}rƒ3(jS]jT]jU]jV]jX]ujLjG3jF]r„3jdX$archr…3…r†3}r‡3(jKUjLj3ubajOjŒubjdX, rˆ3…r‰3}rŠ3(jKX, jLjG3ubj„)r‹3}rŒ3(jKX``$abi``jQ}r3(jS]jT]jU]jV]jX]ujLjG3jF]rŽ3jdX$abir3…r3}r‘3(jKUjLj‹3ubajOjŒubjdX, r’3…r“3}r”3(jKX, jLjG3ubj„)r•3}r–3(jKX ``$abitag``jQ}r—3(jS]jT]jU]jV]jX]ujLjG3jF]r˜3jdX$abitagr™3…rš3}r›3(jKUjLj•3ubajOjŒubjdX, rœ3…r3}rž3(jKjl3jLjG3ubj„)rŸ3}r 3(jKX``$test-suite``jQ}r¡3(jS]jT]jU]jV]jX]ujLjG3jF]r¢3jdX $test-suiter£3…r¤3}r¥3(jKUjLjŸ3ubajOjŒubjdX, and r¦3…r§3}r¨3(jKX, and jMNjZNj[hjLjG3ubj„)r©3}rª3(jKX ``$result``jQ}r«3(jS]jT]jU]jV]jX]ujLjG3jF]r¬3jdX$resultr­3…r®3}r¯3(jKUjLj©3ubajOjŒubjdX.…r°3}r±3(jKX.jMNjZNj[hjLjG3ubeubaubeubj”)r²3}r³3(jKUjLjÅ2jMjNjOj—jQ}r´3(jV]jU]jS]jT]jX]Uentries]rµ3(jšX2setup-test command line option; --machine-log=pathhÒUNtr¶3aujZNj[hjF]ubjœ)r·3}r¸3(jKUjLjÅ2jMjNjOjŸjQ}r¹3(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionrº3j¥jº3ujZNj[hjF]r»3(j§)r¼3}r½3(jKX--machine-log=pathjLj·3jMjNjOjªjQ}r¾3(j¬]r¿3X --machine-logrÀ3ajV]rÁ3hÒajU]jS]jT]jX]rÂ3h*aj²‰ujZM—j[hjF]rÃ3(j´)rÄ3}rÅ3(jKjÀ3jLj¼3jMjNjOj·jQ}rÆ3(j¿jÀjV]jU]jS]jT]jX]ujZM—j[hjF]rÇ3jdX --machine-logrÈ3…rÉ3}rÊ3(jKUjMNjZNj[hjLjÄ3ubaubj½)rË3}rÌ3(jKX=pathjLj¼3jMjNjOjÀjQ}rÍ3(j¿jÀjV]jU]jS]jT]jX]ujZM—j[hjF]rÎ3jdX=pathrÏ3…rÐ3}rÑ3(jKUjMNjZNj[hjLjË3ubaubeubjØ)rÒ3}rÓ3(jKUjLj·3jMjNjOjÛjQ}rÔ3(jS]jT]jU]jV]jX]ujZM—j[hjF]rÕ3j{)rÖ3}r×3(jKXÞ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``.jLjÒ3jMjNjOj~jQ}rØ3(jS]jT]jU]jV]jX]ujZM“j[hjF]rÙ3(jdX2The path to the machine-readable log, relative to rÚ3…rÛ3}rÜ3(jKX2The path to the machine-readable log, relative to jMNjZNj[hjLjÖ3ubj„)rÝ3}rÞ3(jKX ``dist/test``jQ}rß3(jS]jT]jU]jV]jX]ujLjÖ3jF]rà3jdX dist/testrá3…râ3}rã3(jKUjLjÝ3ubajOjŒubjdX. The default template is rä3…rå3}ræ3(jKX. The default template is jMNjZNj[hjLjÖ3ubj„)rç3}rè3(jKX``$pkgid.log``jQ}ré3(jS]jT]jU]jV]jX]ujLjÖ3jF]rê3jdX $pkgid.logrë3…rì3}rí3(jKUjLjç3ubajOjŒubjdX". Template variables allowed are: rî3…rï3}rð3(jKX". Template variables allowed are: jMNjZNj[hjLjÖ3ubj„)rñ3}rò3(jKX ``$pkgid``jQ}ró3(jS]jT]jU]jV]jX]ujLjÖ3jF]rô3jdX$pkgidrõ3…rö3}r÷3(jKUjLjñ3ubajOjŒubjdX, rø3…rù3}rú3(jKX, rû3jMNjZNj[hjLjÖ3ubj„)rü3}rý3(jKX ``$compiler``jQ}rþ3(jS]jT]jU]jV]jX]ujLjÖ3jF]rÿ3jdX $compilerr4…r4}r4(jKUjLjü3ubajOjŒubjdX, r4…r4}r4(jKX, jLjÖ3ubj„)r4}r4(jKX``$os``jQ}r4(jS]jT]jU]jV]jX]ujLjÖ3jF]r 4jdX$osr 4…r 4}r 4(jKUjLj4ubajOjŒubjdX, r 4…r4}r4(jKX, jLjÖ3ubj„)r4}r4(jKX ``$arch``jQ}r4(jS]jT]jU]jV]jX]ujLjÖ3jF]r4jdX$archr4…r4}r4(jKUjLj4ubajOjŒubjdX, r4…r4}r4(jKX, jLjÖ3ubj„)r4}r4(jKX``$abi``jQ}r4(jS]jT]jU]jV]jX]ujLjÖ3jF]r4jdX$abir4…r4}r 4(jKUjLj4ubajOjŒubjdX, r!4…r"4}r#4(jKjû3jLjÖ3ubj„)r$4}r%4(jKX ``$abitag``jQ}r&4(jS]jT]jU]jV]jX]ujLjÖ3jF]r'4jdX$abitagr(4…r)4}r*4(jKUjLj$4ubajOjŒubjdX and r+4…r,4}r-4(jKX and jMNjZNj[hjLjÖ3ubj„)r.4}r/4(jKX ``$result``jQ}r04(jS]jT]jU]jV]jX]ujLjÖ3jF]r14jdX$resultr24…r34}r44(jKUjLj.4ubajOjŒubjdX.…r54}r64(jKX.jMNjZNj[hjLjÖ3ubeubaubeubj”)r74}r84(jKUjLjÅ2jMjNjOj—jQ}r94(jV]jU]jS]jT]jX]Uentries]r:4(jšX5setup-test command line option; --show-details=filterhôUNtr;4aujZNj[hjF]ubjœ)r<4}r=4(jKUjLjÅ2jMjNjOjŸjQ}r>4(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr?4j¥j?4ujZNj[hjF]r@4(j§)rA4}rB4(jKX--show-details=filterjLj<4jMjNjOjªjQ}rC4(j¬]rD4X--show-detailsrE4ajV]rF4hôajU]jS]jT]jX]rG4hMaj²‰ujZMžj[hjF]rH4(j´)rI4}rJ4(jKjE4jLjA4jMjNjOj·jQ}rK4(j¿jÀjV]jU]jS]jT]jX]ujZMžj[hjF]rL4jdX--show-detailsrM4…rN4}rO4(jKUjMNjZNj[hjLjI4ubaubj½)rP4}rQ4(jKX=filterjLjA4jMjNjOjÀjQ}rR4(j¿jÀjV]jU]jS]jT]jX]ujZMžj[hjF]rS4jdX=filterrT4…rU4}rV4(jKUjMNjZNj[hjLjP4ubaubeubjØ)rW4}rX4(jKUjLj<4jMjNjOjÛjQ}rY4(jS]jT]jU]jV]jX]ujZMžj[hjF]rZ4j{)r[4}r\4(jKXá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).jLjW4jMjNjOj~jQ}r]4(jS]jT]jU]jV]jX]ujZMšj[hjF]r^4(jdXUDetermines if the results of individual test cases are shown on the terminal. May be r_4…r`4}ra4(jKXUDetermines if the results of individual test cases are shown on the terminal. May be jMNjZNj[hjLj[4ubj„)rb4}rc4(jKX ``always``jQ}rd4(jS]jT]jU]jV]jX]ujLj[4jF]re4jdXalwaysrf4…rg4}rh4(jKUjLjb4ubajOjŒubjdX (always show), ri4…rj4}rk4(jKX (always show), jMNjZNj[hjLj[4ubj„)rl4}rm4(jKX ``never``jQ}rn4(jS]jT]jU]jV]jX]ujLj[4jF]ro4jdXneverrp4…rq4}rr4(jKUjLjl4ubajOjŒubjdX (never show), rs4…rt4}ru4(jKX (never show), jMNjZNj[hjLj[4ubj„)rv4}rw4(jKX ``failures``jQ}rx4(jS]jT]jU]jV]jX]ujLj[4jF]ry4jdXfailuresrz4…r{4}r|4(jKUjLjv4ubajOjŒubjdX (show only failed results), or r}4…r~4}r4(jKX (show only failed results), or jMNjZNj[hjLj[4ubj„)r€4}r4(jKX ``streaming``jQ}r‚4(jS]jT]jU]jV]jX]ujLj[4jF]rƒ4jdX streamingr„4…r…4}r†4(jKUjLj€4ubajOjŒubjdX! (show all results in real time).r‡4…rˆ4}r‰4(jKX! (show all results in real time).jMNjZNj[hjLj[4ubeubaubeubj”)rŠ4}r‹4(jKUjLjÅ2jMNjOj—jQ}rŒ4(jV]jU]jS]jT]jX]Uentries]r4((jšX6setup-test command line option; --test-options=optionshÅUNtrŽ4(jšXKsetup-test command line option; Give extra options to the test executables.j?UNtr4eujZNj[hjF]ubjœ)r4}r‘4(jKUjLjÅ2jMNjOjŸjQ}r’4(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr“4j¥j“4ujZNj[hjF]r”4(j§)r•4}r–4(jKX--test-options=optionsjLj4jMjNjOjªjQ}r—4(j¬]r˜4X--test-optionsr™4ajV]rš4hÅajU]jS]jT]jX]r›4haj²‰ujZM¡j[hjF]rœ4(j´)r4}rž4(jKj™4jLj•4jMjNjOj·jQ}rŸ4(j¿jÀjV]jU]jS]jT]jX]ujZM¡j[hjF]r 4jdX--test-optionsr¡4…r¢4}r£4(jKUjMNjZNj[hjLj4ubaubj½)r¤4}r¥4(jKX=optionsjLj•4jMjNjOjÀjQ}r¦4(j¿jÀjV]jU]jS]jT]jX]ujZM¡j[hjF]r§4jdX=optionsr¨4…r©4}rª4(jKUjMNjZNj[hjLj¤4ubaubeubj§)r«4}r¬4(jKX+Give extra options to the test executables.jLj4jMjNjOjªjQ}r­4(j¬]r®4XGiver¯4ajV]r°4j?ajU]jS]jT]jX]r±4hžaj²‰ujZM¡j[hjF]r²4(j´)r³4}r´4(jKj¯4jLj«4jMjNjOj·jQ}rµ4(j¿jÀjV]jU]jS]jT]jX]ujZM¡j[hjF]r¶4jdXGiver·4…r¸4}r¹4(jKUjMNjZNj[hjLj³4ubaubj½)rº4}r»4(jKX' extra options to the test executables.jLj«4jMjNjOjÀjQ}r¼4(j¿jÀjV]jU]jS]jT]jX]ujZM¡j[hjF]r½4jdX' extra options to the test executables.r¾4…r¿4}rÀ4(jKUjMNjZNj[hjLjº4ubaubeubjØ)rÁ4}rÂ4(jKUjLj4jMjNjOjÛjQ}rÃ4(jS]jT]jU]jV]jX]ujZM¡j[hjF]ubeubj”)rÄ4}rÅ4(jKUjLjÅ2jMjNjOj—jQ}rÆ4(jV]jU]jS]jT]jX]Uentries]rÇ4(jšX4setup-test command line option; --test-option=optionh¹UNtrÈ4aujZNj[hjF]ubjœ)rÉ4}rÊ4(jKUjLjÅ2jMjNjOjŸjQ}rË4(j¡‰j¢XstdjV]jU]jS]jT]jX]j£XoptionrÌ4j¥jÌ4ujZNj[hjF]rÍ4(j§)rÎ4}rÏ4(jKX--test-option=optionjLjÉ4jMjNjOjªjQ}rÐ4(j¬]rÑ4X --test-optionrÒ4ajV]rÓ4h¹ajU]jS]jT]jX]rÔ4haj²‰ujZM§j[hjF]rÕ4(j´)rÖ4}r×4(jKjÒ4jLjÎ4jMjNjOj·jQ}rØ4(j¿jÀjV]jU]jS]jT]jX]ujZM§j[hjF]rÙ4jdX --test-optionrÚ4…rÛ4}rÜ4(jKUjMNjZNj[hjLjÖ4ubaubj½)rÝ4}rÞ4(jKX=optionjLjÎ4jMjNjOjÀjQ}rß4(j¿jÀjV]jU]jS]jT]jX]ujZM§j[hjF]rà4jdX=optionrá4…râ4}rã4(jKUjMNjZNj[hjLjÝ4ubaubeubjØ)rä4}rå4(jKUjLjÉ4jMjNjOjÛjQ}ræ4(jS]jT]jU]jV]jX]ujZM§j[hjF]rç4j{)rè4}ré4(jKX­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ê4jLjä4jMjNjOj~jQ}rë4(jS]jT]jU]jV]jX]ujZM¤j[hjF]rì4jdX­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(jKjê4jMNjZNj[hjLjè4ubaubaubeubjã)rð4}rñ4(jKX.. _setup-sdist:jLjÅ2jMjNjOjæjQ}rò4(jV]jU]jS]jT]jX]jèhéujZM¨j[hjF]ubeubjH)ró4}rô4(jKUjLjéjMjNjë}rõ4hAjð4sjOjPjQ}rö4(jS]jT]jU]jV]r÷4(héjAejX]rø4(h hAeujZM«j[hjð}rù4héjð4sjF]rú4(j])rû4}rü4(jKX setup sdistrý4jLjó4jMjNjOjajQ}rþ4(jS]jT]jU]jV]jX]ujZM«j[hjF]rÿ4jdX setup sdistr5…r5}r5(jKjý4jMNjZNj[hjLjû4ubaubj{)r5}r5(jKXò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.jLjó4jMjNjOj~jQ}r5(jS]jT]jU]jV]jX]ujZM­j[hjF]r5(jdXHCreate a system- and compiler-independent source distribution in a file r5…r5}r 5(jKXHCreate a system- and compiler-independent source distribution in a file jMNjZNj[hjLj5ubj¿)r 5}r 5(jKX *package*jQ}r 5(jS]jT]jU]jV]jX]ujLj5jF]r 5jdXpackager5…r5}r5(jKUjLj 5ubajOjÇubjdX-…r5}r5(jKX-jMNjZNj[hjLj5ubj¿)r5}r5(jKX *version*jQ}r5(jS]jT]jU]jV]jX]ujLj5jF]r5jdXversionr5…r5}r5(jKUjLj5ubajOjÇubjdX…r5}r5(jKX\ jMNjZNj[hjLj5ubj„)r5}r5(jKX ``.tar.gz``jQ}r5(jS]jT]jU]jV]jX]ujLj5jF]r5jdX.tar.gzr 5…r!5}r"5(jKUjLj5ubajOjŒubjdX in the r#5…r$5}r%5(jKX in the jMNjZNj[hjLj5ubj„)r&5}r'5(jKX``dist``jQ}r(5(jS]jT]jU]jV]jX]ujLj5jF]r)5jdXdistr*5…r+5}r,5(jKUjLj&5ubajOjŒubjdXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.r-5…r.5}r/5(jKXz subdirectory, for distribution to package builders. When unpacked, the commands listed in this section will be available.jMNjZNj[hjLj5ubeubj{)r05}r15(jKXYThe 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.jLjó4jMjNjOj~jQ}r25(jS]jT]jU]jV]jX]ujZM²j[hjF]r35(jdX³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 r45…r55}r65(jKX³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 jMNjZNj[hjLj05ubj„)r75}r85(jKX``license-file``jQ}r95(jS]jT]jU]jV]jX]ujLj05jF]r:5jdX license-filer;5…r<5}r=5(jKUjLj75ubajOjŒubjdX, r>5…r?5}r@5(jKX, rA5jMNjZNj[hjLj05ubj„)rB5}rC5(jKX ``main-is``jQ}rD5(jS]jT]jU]jV]jX]ujLj05jF]rE5jdXmain-isrF5…rG5}rH5(jKUjLjB5ubajOjŒubjdX, rI5…rJ5}rK5(jKX, rL5jMNjZNj[hjLj05ubj„)rM5}rN5(jKX ``c-sources``jQ}rO5(jS]jT]jU]jV]jX]ujLj05jF]rP5jdX c-sourcesrQ5…rR5}rS5(jKUjLjM5ubajOjŒubjdX, rT5…rU5}rV5(jKX, jLj05ubj„)rW5}rX5(jKX``asm-sources``jQ}rY5(jS]jT]jU]jV]jX]ujLj05jF]rZ5jdX asm-sourcesr[5…r\5}r]5(jKUjLjW5ubajOjŒubjdX, r^5…r_5}r`5(jKX, jLj05ubj„)ra5}rb5(jKX``cmm-sources``jQ}rc5(jS]jT]jU]jV]jX]ujLj05jF]rd5jdX cmm-sourcesre5…rf5}rg5(jKUjLja5ubajOjŒubjdX, rh5…ri5}rj5(jKX, jLj05ubj„)rk5}rl5(jKX``js-sources``jQ}rm5(jS]jT]jU]jV]jX]ujLj05jF]rn5jdX js-sourcesro5…rp5}rq5(jKUjLjk5ubajOjŒubjdX, rr5…rs5}rt5(jKjL5jLj05ubj„)ru5}rv5(jKX``data-files``jQ}rw5(jS]jT]jU]jV]jX]ujLj05jF]rx5jdX data-filesry5…rz5}r{5(jKUjLju5ubajOjŒubjdX, r|5…r}5}r~5(jKjA5jLj05ubj„)r5}r€5(jKX``extra-source-files``jQ}r5(jS]jT]jU]jV]jX]ujLj05jF]r‚5jdXextra-source-filesrƒ5…r„5}r…5(jKUjLj5ubajOjŒubjdX and r†5…r‡5}rˆ5(jKX and jMNjZNj[hjLj05ubj„)r‰5}rŠ5(jKX``extra-doc-files``jQ}r‹5(jS]jT]jU]jV]jX]ujLj05jF]rŒ5jdXextra-doc-filesr5…rŽ5}r5(jKUjLj‰5ubajOjŒubjdX fields.r5…r‘5}r’5(jKX fields.jMNjZNj[hjLj05ubeubj{)r“5}r”5(jKX(This command takes the following option:r•5jLjó4jMjNjOj~jQ}r–5(jS]jT]jU]jV]jX]ujZM¸j[hjF]r—5jdX(This command takes the following option:r˜5…r™5}rš5(jKj•5jMNjZNj[hjLj“5ubaubj”)r›5}rœ5(jKUjLjó4jMjNjOj—jQ}r5(jV]jU]jS]jT]jX]Uentries]rž5(jšX+setup-sdist command line option; --snapshothÑUNtrŸ5aujZNj[hjF]ubjœ)r 5}r¡5(jKUjLjó4jMjNjOjŸjQ}r¢5(j¡‰j¢XstdjV]jU]jS]jT]jX]j£Xoptionr£5j¥j£5ujZNj[hjF]r¤5(j§)r¥5}r¦5(jKX --snapshotr§5jLj 5jMjNjOjªjQ}r¨5(j¬]r©5j§5ajV]rª5hÑajU]jS]jT]jX]r«5h)aj²‰ujZMÁj[hjF]r¬5(j´)r­5}r®5(jKj§5jLj¥5jMjNjOj·jQ}r¯5(j¿jÀjV]jU]jS]jT]jX]ujZMÁj[hjF]r°5jdX --snapshotr±5…r²5}r³5(jKUjMNjZNj[hjLj­5ubaubj½)r´5}rµ5(jKUjLj¥5jMjNjOjÀjQ}r¶5(j¿jÀjV]jU]jS]jT]jX]ujZMÁj[hjF]ubeubjØ)r·5}r¸5(jKUjLj 5jMjNjOjÛjQ}r¹5(jS]jT]jU]jV]jX]ujZMÁj[hjF]rº5j{)r»5}r¼5(jKX†Append today's date (in "YYYYMMDD" format) to the version number for the generated source package. The original package is unaffected.r½5jLj·5jMjNjOj~jQ}r¾5(jS]jT]jU]jV]jX]ujZM¾j[hjF]r¿5jdXŒ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(jKj½5jMNjZNj[hjLj»5ubaubaubeubjÁ*)rÃ5}rÄ5(jKX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyjLjó4jMcdocutils.nodes reprunicode rÅ5Xdoc/references.incrÆ5…rÇ5}rÈ5bjOjÄ*jQ}rÉ5(j¿jÀjV]jU]jS]jT]jX]ujZKj[hjF]rÊ5jdX[-*- rst -*- This file contains commonly used link-references See also "extlinks" in conf.pyrË5…rÌ5}rÍ5(jKUjLjÃ5ubaubjã)rÎ5}rÏ5(jKX .. _`Package Versioning Policy`:jLjó4jMjÇ5jOjæjQ}rÐ5(jV]jU]jS]jT]jX]jèj)ujZMÈj[hjF]ubjã)rÑ5}rÒ5(jKX .. _PVP: http://pvp.haskell.org/jLjó4jMjÇ5jë}rÓ5h‡jÎ5sjOjæjQ}rÔ5(jìXhttp://pvp.haskell.org/jV]rÕ5(hój)ejU]jS]jT]jX]rÖ5(hLh‡eujZMÉj[hjð}r×5j)jÎ5sjF]ubjã)rØ5}rÙ5(jKX(.. _Hackage: http://hackage.haskell.org/jhKjLjó4jMjÇ5jOjæjQ}rÚ5(jìjíjV]rÛ5jEajU]jS]jT]jX]rÜ5h¤aujZMËj[hjF]ubjã)rÝ5}rÞ5(jKX$.. _Haskell: http://www.haskell.org/jLjó4jMjÇ5jOjæjQ}rß5(jìXhttp://www.haskell.org/jV]rà5jajU]jS]jT]jX]rá5h_aujZMÍj[hjF]ubjã)râ5}rã5(jKX,.. _Haddock: http://www.haskell.org/haddock/jhKjLjó4jMjÇ5jOjæjQ}rä5(jìjë+jV]rå5j!ajU]jS]jT]jX]ræ5h}aujZMÏj[hjF]ubjã)rç5}rè5(jKX&.. _Alex: http://www.haskell.org/alex/jLjó4jMjÇ5jOjæjQ}ré5(jìXhttp://www.haskell.org/alex/jV]rê5hõajU]jS]jT]jX]rë5hNaujZMÑj[hjF]ubjã)rì5}rí5(jKX(.. _Happy: http://www.haskell.org/happy/jLjó4jMjÇ5jOjæjQ}rî5(jìXhttp://www.haskell.org/happy/jV]rï5jajU]jS]jT]jX]rð5hnaujZMÓj[hjF]ubjã)rñ5}rò5(jKX*.. _Hoogle: http://www.haskell.org/hoogle/jhKjLjó4jMjÇ5jOjæjQ}ró5(jìjg,jV]rô5jajU]jS]jT]jX]rõ5haaujZMÕj[hjF]ubjã)rö5}r÷5(jKX9.. _HsColour: http://www.cs.york.ac.uk/fp/darcs/hscolour/jhKjLjó4jMjÇ5jOjæjQ}rø5(jìjÝ-jV]rù5häajU]jS]jT]jX]rú5h6}r?6(jKUjQ}r@6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineM€Utypej6ujF]rA6j{)rB6}rC6(jKUjQ}rD6(jS]jT]jU]jV]jX]ujLj>6jF]rE6jdX3Hyperlink target "setup-haddock" is not referenced.rF6…rG6}rH6(jKUjLjB6ubajOj~ubajOj'6ubj6)rI6}rJ6(jKUjQ}rK6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineMÅUtypej6ujF]rL6j{)rM6}rN6(jKUjQ}rO6(jS]jT]jU]jV]jX]ujLjI6jF]rP6jdX4Hyperlink target "setup-hscolour" is not referenced.rQ6…rR6}rS6(jKUjLjM6ubajOj~ubajOj'6ubj6)rT6}rU6(jKUjQ}rV6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineMÝUtypej6ujF]rW6j{)rX6}rY6(jKUjQ}rZ6(jS]jT]jU]jV]jX]ujLjT6jF]r[6jdX3Hyperlink target "setup-install" is not referenced.r\6…r]6}r^6(jKUjLjX6ubajOj~ubajOj'6ubj6)r_6}r`6(jKUjQ}ra6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineMùUtypej6ujF]rb6j{)rc6}rd6(jKUjQ}re6(jS]jT]jU]jV]jX]ujLj_6jF]rf6jdX0Hyperlink target "setup-copy" is not referenced.rg6…rh6}ri6(jKUjLjc6ubajOj~ubajOj'6ubj6)rj6}rk6(jKUjQ}rl6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineM Utypej6ujF]rm6j{)rn6}ro6(jKUjQ}rp6(jS]jT]jU]jV]jX]ujLjj6jF]rq6jdX4Hyperlink target "setup-register" is not referenced.rr6…rs6}rt6(jKUjLjn6ubajOj~ubajOj'6ubj6)ru6}rv6(jKUjQ}rw6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineMKUtypej6ujF]rx6j{)ry6}rz6(jKUjQ}r{6(jS]jT]jU]jV]jX]ujLju6jF]r|6jdX6Hyperlink target "setup-unregister" is not referenced.r}6…r~6}r6(jKUjLjy6ubajOj~ubajOj'6ubj6)r€6}r6(jKUjQ}r‚6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineMfUtypej6ujF]rƒ6j{)r„6}r…6(jKUjQ}r†6(jS]jT]jU]jV]jX]ujLj€6jF]r‡6jdX1Hyperlink target "setup-clean" is not referenced.rˆ6…r‰6}rŠ6(jKUjLj„6ubajOj~ubajOj'6ubj6)r‹6}rŒ6(jKUjQ}r6(jS]UlevelKjV]jU]UsourcejNjT]jX]UlineM¨Utypej6ujF]rŽ6j{)r6}r6(jKUjQ}r‘6(jS]jT]jU]jV]jX]ujLj‹6jF]r’6jdX1Hyperlink target "setup-sdist" is not referenced.r“6…r”6}r•6(jKUjLj6ubajOj~ubajOj'6ubj6)r–6}r—6(jKUjQ}r˜6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÈUtypej6ujF]r™6j{)rš6}r›6(jKUjQ}rœ6(jS]jT]jU]jV]jX]ujLj–6jF]r6jdX?Hyperlink target "package-versioning-policy" is not referenced.rž6…rŸ6}r 6(jKUjLjš6ubajOj~ubajOj'6ubj6)r¡6}r¢6(jKUjQ}r£6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÉUtypej6ujF]r¤6j{)r¥6}r¦6(jKUjQ}r§6(jS]jT]jU]jV]jX]ujLj¡6jF]r¨6jdX)Hyperlink target "pvp" is not referenced.r©6…rª6}r«6(jKUjLj¥6ubajOj~ubajOj'6ubj6)r¬6}r­6(jKUjQ}r®6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÍUtypej6ujF]r¯6j{)r°6}r±6(jKUjQ}r²6(jS]jT]jU]jV]jX]ujLj¬6jF]r³6jdX-Hyperlink target "haskell" is not referenced.r´6…rµ6}r¶6(jKUjLj°6ubajOj~ubajOj'6ubj6)r·6}r¸6(jKUjQ}r¹6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÑUtypej6ujF]rº6j{)r»6}r¼6(jKUjQ}r½6(jS]jT]jU]jV]jX]ujLj·6jF]r¾6jdX*Hyperlink target "alex" is not referenced.r¿6…rÀ6}rÁ6(jKUjLj»6ubajOj~ubajOj'6ubj6)rÂ6}rÃ6(jKUjQ}rÄ6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÓUtypej6ujF]rÅ6j{)rÆ6}rÇ6(jKUjQ}rÈ6(jS]jT]jU]jV]jX]ujLjÂ6jF]rÉ6jdX+Hyperlink target "happy" is not referenced.rÊ6…rË6}rÌ6(jKUjLjÆ6ubajOj~ubajOj'6ubj6)rÍ6}rÎ6(jKUjQ}rÏ6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÙUtypej6ujF]rÐ6j{)rÑ6}rÒ6(jKUjQ}rÓ6(jS]jT]jU]jV]jX]ujLjÍ6jF]rÔ6jdX+Hyperlink target "cpphs" is not referenced.rÕ6…rÖ6}r×6(jKUjLjÑ6ubajOj~ubajOj'6ubj6)rØ6}rÙ6(jKUjQ}rÚ6(jS]UlevelKjV]jU]UsourcejÇ5jT]jX]UlineMÛUtypej6ujF]rÛ6j{)rÜ6}rÝ6(jKUjQ}rÞ6(jS]jT]jU]jV]jX]ujLjØ6jF]rß6jdX*Hyperlink target "abnf" is not referenced.rà6…rá6}râ6(jKUjLjÜ6ubajOj~ubajOj'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þ6NjaNUerror_encoding_error_handlerrÿ6Ubackslashreplacer7Udebugr7NUembed_stylesheetr7‰Uoutput_encoding_error_handlerr7Ustrictr7U sectnum_xformr7KUdump_transformsr7NU docinfo_xformr7KUwarning_streamr7NUpep_file_url_templater 7Upep-%04dr 7Uexit_status_levelr 7KUconfigr 7NUstrict_visitorr 7NUcloak_email_addressesr7ˆUtrim_footnote_reference_spacer7‰Uenvr7NUdump_pseudo_xmlr7NUexpose_internalsr7NUsectsubtitle_xformr7‰U source_linkr7NUrfc_referencesr7NUoutput_encodingr7Uutf-8r7U source_urlr7NUinput_encodingr7U utf-8-sigr7U_disable_configr7NU id_prefixr7UUcharacter_level_inline_markupr7‰U tab_widthr7KUerror_encodingr7UUTF-8r 7U_sourcer!7jNUgettext_compactr"7ˆU generatorr#7NUdump_internalsr$7NU smart_quotesr%7ˆU pep_base_urlr&7U https://www.python.org/dev/peps/r'7Usyntax_highlightr(7Ulongr)7Uinput_encoding_error_handlerr*7j7Uauto_id_prefixr+7Uidr,7Udoctitle_xformr-7‰Ustrip_elements_with_classesr.7NU _config_filesr/7]Ufile_insertion_enabledr07ˆU raw_enabledr17KU dump_settingsr27NubUsymbol_footnote_startr37KUidsr47}r57(hàj»(h×jFhòjô#jjl&j2jÑ+h±jx1hÔjnhµj&2hÙjÙ h¶jÑ+h¯j+hºjèhâjj@jÍ'hÑj¥5jj  j3j¹%hÃjö$hÆj÷)j;jÏj?j«4jj\j(j²0hÁjv"hÉjc+hõjç5h¾jéhÌjô!jCjðj%jÉj j jj¢1hójÑ5j1jÔ h¸j+hÜjˆjj1 hþjEhãjJhÒj¼3häjö5håj/jjd!jjŠ0héjó4j-jx1hÀj1j,jà/hïj 0j$jI.hëj/j=jc+hÖj»j'jfj.jj)jÑ5hùjû5hÝj¢hÎj“h¿jÊ1h½j•$hçjª hýjÅ2hßj*,hÚjjj\j9jô,hæj¨hèjò1jjÝ5j jŠ jjvj*jb0hîjj-jj\$jjmhíj &jj/0hûj.hújF'jjñ5hØj/-hìjÌ!jj¤/h÷jIj j6h²jÊ jƒj~jjG1jAjó4h»jî.j0jp(hÂj<jj`/hüjß&j+já%jjì5j jøh³jÝhÍj, h¹jÎ4j#j”&h°jÎ$jjfhôjA4hñjî2j!jâ5hÞjÅj/j4j4j1&hájÞ"h¼j¬jjN"hÈj•2hÊj·h´j-3hÏj hÿjí0jj#jj höj£j8j† hÇj%jj˜.j5jI.hÓj%!jjmj"j,jj|j7jéhÛjÓj&j³-hÅj•4j:jÚjj hðjÛ*j<j hÐj¡'hÄj‹høj€%jj<j6j1 h·jÔj j&2hÕj((hêjgj j'jBjà/h®jð hËj/0jDjjEjØ5j>jO%uUsubstitution_namesr67}r77jOj[jQ}r87(jS]jV]jU]UsourcejNjT]jX]uU footnotesr97]r:7Urefidsr;7}r<7(h¶]r=7jÎ+aj]r>7jcahé]r?7jð4aj7]r@7jäaj)]rA7jÎ5aj]rB7j,0ah±]rC7ju1ajB]rD7jÝ/ahµ]rE7j#2ahÉ]rF7j`+ahå]rG7j/aj5]rH7jF.auub.