V      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~                                  ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C D E F G H I J KLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~     !!!!""""""""""""""""""###$$$$%%&'''''((((((((((((())))))))**************************** * * * * *********++++++++3,-. !"#$!"#$/%&''0()*+,()*+,1portablelibraries@haskell.org -@Describes whether an option takes an argument or not, and if so 3 how the argument is injected into a value of type a. .optional argument /option requires argument 0no argument expected 1Each 1 describes a single option. The arguments to 2 are: ! list of short option characters & list of long option strings (without "--")  argument descriptor  explanation of option for user 3.What to do with options following non-options 4wrap non-options into options 5+freely intersperse options and non-options 6,no option processing after first non-option 7@Return a string describing the usage of a command, derived from > the header (first argument) and the options described by the  second argument. 8EProcess the command-line, and return the list of values that matched (and those that didn't). The arguments are:  The order requirements (see 3)  The option descriptions (see 1) 8 The actual command line arguments (presumably got from  System.Environment.getArgs). 8= returns a triple consisting of the option arguments, a list .of non-options, and a list of error messages. 9This is almost the same as 8, but returns a quadruple Econsisting of the option arguments, a list of non-options, a list of 4unrecognized options, and a list of error messages. -./0123456789 -0/../01223654456789portablelibraries@haskell.org )Consumes and returns the next character. $ Fails if there is no input left. @Look-ahead: returns the part of the input that is left, without  consuming it. Always fails. Symmetric choice. 5Local, exclusive, left-biased choice: If left parser < locally produces any result at all, then right parser is  not used. 5Transforms a parser into one that does the same, but 2 in addition returns the exact characters read.  IMPORTANT NOTE: - gives a runtime error if its first argument 1 is built using any occurrences of readS_to_P. =Consumes and returns the next character, if it satisfies the  specified predicate. ,Parses and returns the specified character. )Parses and returns the specified string. CParses the first zero or more characters satisfying the predicate. BParses the first one or more characters satisfying the predicate. ,Combines all parsers in the specified list. Skips all whitespace.  count n p  parses n occurrences of p in sequence. A list of  results is returned.  between open close p  parses open, followed by p and finally  close. Only the value of p is returned.  option x p will either parse p or return x without consuming  any input.  optional p optionally parses p and always returns (). 5Parses zero or more occurrences of the given parser. 4Parses one or more occurrences of the given parser. Like , but discards the result. Like , but discards the result.  sepBy p sep$ parses zero or more occurrences of p, separated by sep. ( Returns a list of values returned by p.  sepBy1 p sep# parses one or more occurrences of p, separated by sep. ( Returns a list of values returned by p.  endBy p sep$ parses zero or more occurrences of p, separated and ended  by sep.  endBy p sep# parses one or more occurrences of p, separated and ended  by sep.  chainr p op x$ parses zero or more occurrences of p, separated by op. ! Returns a value produced by a right associative application of all  functions returned by op!. If there are no occurrences of p, x is  returned.  chainl p op x$ parses zero or more occurrences of p, separated by op. ! Returns a value produced by a left associative application of all  functions returned by op!. If there are no occurrences of p, x is  returned. Like (, but parses one or more occurrences of p. Like (, but parses one or more occurrences of p. manyTill p end$ parses zero or more occurrences of p, until end 2 succeeds. Returns a list of values returned by p. 7Converts a parser into a Haskell ReadS-style function. ) This is the main way in which you can "run" a  parser:  the expanded type is  / readP_to_S :: ReadP a -> String -> [(a,String)]  7Converts a Haskell ReadS-style function into a parser. @ Warning: This introduces local backtracking in the resulting 2 parser, and therefore a possible inefficiency. ":  !  !  portablecabal-devel@haskell.org!"#$%!"#$%!"#"#$%portablecabal-devel@haskell.org2/Does this version fall within the given range? ;x.y.* becomes >= x.y && < x.(y+1) <isWildcardRange [x,y] [x,y+1] = True =>?@&'()*+,-./012 &,+*)('./012- &,+*)(''()*+,-./012portablelibraries@haskell.org3?This represents language extensions beyond Haskell 98 that are B supported by some implementations, usually in some special mode. ;BAllow imports to be qualified by the package name that the module ' is intended to be imported from, e.g. ! import "network" Network.Socket AB23 for 31s is really really slow so for the Text instance G what we do is make a simple table indexed off the first letter in the > extension name. The extension names actually cover the range 'A'-'U' 1 pretty densely and the biggest bucket is 7 so it's not too bad. We just do % a linear search within each bucket. EThis gives an order of magnitude improvement in parsing speed, and it'll F also allow us to do case insensitive matches in future if we prefer. =3456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmno=3nmlkjihgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGFEDCBA@?>=<;:987654o=3;nmlkjihgfedcba`_^]\[ZYXWVUTSRQPONMLKJIHGFEDCBA@?>=<;:987654456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnoportablecabal-devel@haskell.orgC3How strict to be when classifying strings into the  and r enums. KThe reason we have multiple ways to do the classification is because there , are two situations where we need to do it. LFor parsing os and arch names in .cabal files we really want everyone to be L referring to the same or or arch by the same name. Variety is not a virtue  in this case. We don't mind about case though. For the System.Info.os/5arch different Haskell implementations use different  names for the same or/3arch. Also they tend to distinguish versions of an  os/arch which we just don't care about. The D@ classification allows us to recognise aliases that are already L in common use but it allows us to distinguish them from the canonical name 9 which enables us to warn about such deprecated aliases. "pqrstuvwxyz{|}~"r~}|{zyxwvutspq"pqqr~}|{zyxwvutsstuvwxyz{|}~ portablecabal-devel@haskell.orgNo unliteration. : takes a filename (for error reports), and transforms the K given string, to eliminate the literate comments from the program text. portablecabal-devel@haskell.org#Parser with simple error reporting portablecabal-devel@haskell.org portablecabal-devel@haskell.org@Subclass of packages that have specific versioned dependencies. HSo for example a not-yet-configured package has dependencies on version M ranges, not specific versions. A configured or an already installed package E depends on exact versions. Some operations or data structures (like H dependency graphs) only make sense on this subclass of package types. ,Class of things that can be identified by a   ITypes in this class are all notions of a package. This allows us to have H different types for the different phases that packages go though, from  simple name/;id, package description, configured or installed packages. #The name and version of a package. "The name of this package, eg. foo $the version of this package, eg 1.2 5Type alias so we can use the shorter name PackageId.  portablecabal-devel@haskell.org portablecabal-devel@haskell.orgEdir prefix and extension, like "foo/bar/*.baz" corresponds to   FileGlob "foo/bar" ".baz" F&No glob at all, just an ordinary file DNon fatal conditions that may be indicative of an error or problem. We display these at the  verbosity level. Useful status messages. We display these at the  verbosity level. FThis is for the ordinary helpful status messages that users see. Just N enough information to know that things are working but not floods of detail. -More detail on the operation of some action. 6We display these messages when the verbosity level is  (Detailed internal debugging information 6We display these messages when the verbosity level is  GPerform an IO action, catching any IO exceptions and printing an error  if one occurs. GWraps text to the default line width. Existing newlines are preserved. IWraps a list of words to a list of lines of words of a particular width. %Run a command and return its output. -The output is assumed to be encoded as UTF8. /Like the unix xargs program. Useful for when we've got very long command I lines that might overflow an OS limit on command line length and so you A need to invoke a command multiple times to get all the args in. AUse it with either of the rawSystem variants above. For example: B xargs (32*1024) (rawSystemExit verbosity) prog fixedArgs bigArgs >Copy the source files into the right directory. Looks in the C build prefix for files that look like the input modules, based on A the input search suffixes. It copies the files into the target  directory. HCopies a bunch of files to a target directory, preserving the directory N structure in the target location. The target directories are created if they  do not exist. LThe files are identified by a pair of base directory and a path relative to B that base. It is only the relative part that is preserved in the  destination.  For example:   copyFiles normal "dist/src" 8 [("", "src/Foo.hs"), ("dist/build/", "src/Bar.hs")] This would copy "src/Foo.hs" to "dist/src/src/Foo.hs" and  copy "dist/build/src/Bar.hs" to "dist/src/src/Bar.hs". LThis operation is not atomic. Any IO failure during the copy (including any N missing source files) leaves the target in an unknown state so it is best to M use it with a freshly created directory so that it can be simply deleted if  anything goes wrong. #Use a temporary filename that doesn't already exist. Use a temporary directory. 7Use this exact given dir which must not already exist. @Gets the contents of a file, but guarantee that it gets closed. KThe file is read lazily but if it is not fully consumed by the action then : the remaining input is truncated and the file is closed. Writes a file atomically. HThe file is either written sucessfully or an IO exception is raised and & the original file is left unchanged. I Warning: On Windows this operation is very nearly but not quite atomic.  See below. KOn Posix it works by writing a temporary file and atomically renaming over > the top any pre-existing target file with the temporary one. LOn Windows it is not possible to rename over an existing file so the target L file has to be deleted before the temporary file is renamed to the target. M Therefore there is a race condition between the existing file being removed I and the temporary file being renamed. Another thread could write to the N target or change the permission on the target directory between the deleting L and renaming steps. An exception would be raised but the target file would L either no longer exist or have the content as written by the other thread. JOn windows it is not possible to delete a file that is open by a process. N This case will give an IO exception but the atomic property is not affected. KWrite a file but only if it would have new content. If we would be writing N the same as the existing content then leave the file as is so that we do not  update the file's modification time. 5The path name that represents the current directory.  In Unix, it's ".", but this is system-specific. % (E.g. AmigaOS uses the empty string "" for the current directory.) Package description file (pkgname.cabal) CFind a package description file in the given directory. Looks for  .cabal files. -Optional auxiliary package information file (pkgname .buildinfo) ;Find auxiliary package information in the given directory.  Looks for  .buildinfo files. 3Reads a UTF8 encoded text file as a Unicode String Reads lazily using ordinary G24. 3Reads a UTF8 encoded text file as a Unicode String Same behaviour as  . 5Writes a Unicode String as a UTF8 encoded text file. Uses  #, so provides the same guarantees. /// portablecabal-devel@haskell.org>The collection of information about packages from one or more  PackageDBs. <It can be searched effeciently by package name and version. HDLookup a name in the index to get all packages that match that name  case-sensitively. +Build an index out of a bunch of packages. 7If there are duplicates, later ones mask earlier ones. Merge two indexes. >Packages from the second mask packages of the same exact name $ (case-sensitively) from the first. I5Elements in the second list mask those in the first. )Inserts a single package into the index. 8This is equivalent to (but slightly quicker than) using J25 or    with a singleton index. KInternal delete helper. )Removes a single package from the index. ERemoves all packages with this (case-sensitive) name from the index. @Removes all packages satisfying this dependency from the index. %Get all the packages from the index. %Get all the packages from the index. 4They are grouped by package name, case-sensitively. "Does a lookup by package id (name & version). MSince multiple package DBs mask each other case-sensitively by package name, ' then we get back at most one package. .Does a case-sensitive search by package name. FDoes a case-sensitive search by package name and a range of versions. FWe get back any number of versions of the specified package name, all * satisfying the version range constraint. 0Does a case-insensitive search by package name. JIf there is only one package that compares case-insentiviely to this name N then the search is unambiguous and we get back all versions of that package. L If several match case-insentiviely but one matches exactly then it is also  unambiguous. JIf however several match case-insentiviely and none match exactly then we G have an ambiguous result, and we get back all the versions of all the L packages. The list of ambiguous results is split by exact package name. So , it is a non-empty list of non-empty lists. :Does a case-insensitive substring search by package name. CThat is, all packages that contain the given string in their name. ?All packages that have dependencies that are not in the index. ;Returns such packages along with the dependencies that they' re missing. BTries to take the transative closure of the package dependencies. IIf the transative closure is complete then it returns that subset of the 7 index. Otherwise it returns the broken packages as in  .  Note that if the result is Right [] it is because at least one of  the original given  s do not occur in the index. CTakes the transative closure of the packages reverse dependencies.  The given  s must be in the index. FGiven a package index where we assume we want to use all the packages  (use  2 if you need to get such a index subset) find out H if the dependencies within it use consistent versions of each package. J Return all cases where multiple packages depend on different versions of  some other package. JEach element in the result is a package name along with the packages that H depend on it and the versions they require. These are guaranteed to be  distinct. FFind if there are any cycles in the dependency graph. If there are no  cycles the result is []. KThis actually computes the strongly connected components. So it gives us a L list of groups of packages where within each group they all depend on each  other, directly or indirectly. ,Builds a graph of the package dependencies. HDependencies on other packages that are not in the index are discarded. 7 You can check if there are any such dependencies with  .  portablecabal-devel@haskell.org%DThe configuration is a collection of information about programs. It M contains information both about configured programs and also about programs  that we are yet to configure. MThe idea is that we start from a collection of unconfigured programs and one F by one we try to configure them at which point we move them into the I configured collection. For unconfigured programs we record not just the    D but also any user-provided arguments and location for the program. 3Where a program was found. Also tells us whether it's specifed by user or A not. This includes not just the path, but the program as well. ;The location of the program, as located by searching PATH.  (The user gave the path to this program,  eg. --ghc-path=/usr/bin/ghc-6.6  Just the name again -The version of this program, if it is known. ,Default command-line args for this program. C These flags will appear first on the command line, so they can be ! overridden by subsequent flags. Location of the program. eg. /usr/bin/ghc-6.4 .Represents a program which can be configured. (The simple name of the program, eg. ghc *A function to search for the program if it's location was not 4 specified by the user. Usually this will just be a BTry to find the version of the program. For many programs this is ' not possible or is not necessary so it's ok to return Nothing. <A function to do any additional configuration after we have A located the program (and perhaps identified its version). It is ? allowed to return additional flags that will be passed to the  program on every invocation. 'The full path of a configured program. Make a simple named program.  By default we':ll just search for it in the path and not try to find the C version name. You can override these behaviours if necessary, eg: L simpleProgram "foo" { programFindLocation = ... , programFindVersion ... }  Look for a program on the path. %Look for a program and try to find it' s version number. It can accept K either an absolute path or the name of a program binary, in which case we ( will look for the program on the path. The Read/5Show instance does not preserve all the unconfigured Programs  because    is not in Read/*Show because it contains functions. So to  fully restore a deserialised   use this function to add  back all the known   s. G It does not add the default programs, but you probably want them, use  3 * in addition to any extra you might need. 0Add a known program that we may configure later #AUser-specify this path. Basically override any path information - for this program in the configuration. If it's not a known  program ignore it. %AUser-specify the arguments for this program. Basically override B any args information for this program in the configuration. If it's " not a known program, ignore it.. &Like # * but for a list of progs and their paths. 'Like # ) but for a list of progs and their args. LGGet the path that has been previously specified for a program, if any. (FGet any extra args that have been previously specified for a program. )!Try to find a configured program *-Update a configured program in the database. +KTry to configure a specific program. If the program is already included in G the colleciton of unconfigured programs then we use any user-supplied L location and arguments. If the program gets configured sucessfully it gets % added to the configured collection. ENote that it is not a failure if the program cannot be configured. It's only N a failure if the user supplied a location and the program could not be found  at that location. BThe reason for it not being a failure at this stage is that we don' t know up G front all the programs we will need, so we try to configure them all. B To verify that a program was actually sucessfully configured use  . . M$Configure a bunch of programs using +  . Just a N26. ,KTry to configure all the known programs that have not yet been configured. -Hreconfigure a bunch of programs given new user-specified args. It takes  the same inputs as #  and %  and for all progs  with a new path it calls + . .<Check that a program is configured and available to be run. GAdditionally check that the version of the program number is suitable.  For example , or orLaterVersion (?27@27 [1,0] []) MIt raises an exception if the program could not be configured or the version = is unsuitable, otherwise it returns the configured program. /#Runs the given configured program. 07Runs the given configured program and gets the output. 1ELooks up the given program in the program configuration and runs it. 2ELooks up the given program in the program configuration and runs it. 3The default list of programs. 8 These programs are typically used internally to Cabal. E      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJF      /03 !"#&$%'()*+,-.12456789:=>?@;<ABCDEFGHIJE           !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJportablecabal-devel@haskell.org K@This datatype indicates the license under which your package is D released. It is also wise to add your license to each source file $ using the license-file field. The N constructor ? is not actually a license, but states that you are not giving E anyone else a license to use or distribute your work. The comments D below are general guidelines. Please read the licenses themselves B and consult a lawyer if you are unsure of your rights to release  the software. LNot a recognised license. ; Allows us to deal with future extensions more gracefully. MSome other license. NDNo rights are granted to others. Undistributable. Most restrictive. O?Holder makes no claim to ownership, least restrictive license. P64-clause BSD license, older, with advertising clause. QG3-clause BSD license, newer, no advertising clause. Very free license. R=Lesser GPL, Less restrictive than GPL, useful for libraries. S<GNU Public License. Source code must accompany alterations. KLMNOPQRS KSRQPONML KSRQPONMLLMNOPQRSportablecabal-devel@haskell.org_Like O+ but compatible with the old ReadS parser. EIt is compatible in the sense that it accepts only the same strings,  eg GHC but not ghc&. However other strings get mapped to W. I The point of this is that we do not allow extra valid values that would L upset older Cabal versions that had a stricter parser however we cope with & new values more gracefully so that we'%ll be able to introduce new value in ) future without breaking things so much. aIThe default compiler flavour to pick when compiling stuff. This defaults . to the compiler used to build the Cabal lib.  However if it'#s not a recognised compiler then it's P28 and the user 0 will have to specify which compiler they want. TUVWXYZ[\]^_`aV^]\[ZYXW`a_TUTUUV^]\[ZYXWWXYZ[\]^_`aportablecabal-devel@haskell.org4g@A boolean expression parameterized over the variable type used. mA ConfVar$ represents the variable type used. rA r" is a total or partial mapping of tss to  Q9:< flag values. It represents the flags chosen by the user or . discovered during configuration. For example --flags=foo --flags=-bar  becomes [(foo , True), (bar, False)] sA ts2 is the name of a user-defined configuration flag uCA flag can represent a feature to be included, or a way of linking L a target against its dependencies, or in fact whatever you can think of. HAn enumeration of common source control systems. The fields used in the  ; depend on the type of repo. The tools and methods used to 4 obtain and track the repo depend on the repo type. 0What this repo info is for, what it represents. EThe repository containing the sources for this exact package version H or release. For this kind of repo a tag should be given to give enough - information to re-create the exact sources. The repository for the "head"( or development version of the project. G This repo is where we should track the latest development activity or 9 the usual repo people should get to contribute patches. DInformation about the source revision control system for a package. LWhen specifying a repo it is useful to know the meaning or intention of the J information as doing so enables automation. There are two obvious common K purposes: one is to find the repo for the latest development version, the : other is to find the repo for this specific release. The ReopKind 6 specifies which one we mean (or another custom one). LA package can specify one or the other kind or both. Most will specify just L a head repo but some may want to specify a repo to reconstruct the sources  for this package release.  The required information is the  which tells us if it's using  ,  for example. The  and other details are ) interpreted according to the repo type. *The kind of repo. This field is required. ;The type of the source repository system for this repo, eg  or  . This field is required. )The location of the repository. For most s this is a URL.  This field is required.  can put multiple "modules" on one server and requires a H module name in addition to the location to identify a particular repo. D Logically this is part of the location but unfortunately has to be 6 specified separately. This field is required for the   and  should not be given otherwise. BThe name or identifier of the branch, if any. Many source control J systems have the notion of multiple branches in a repo that exist in the  same location. For example  and  use this while systems like  ? use different locations for different branches. This field is C optional but should be used if necessary to identify the sources,  especially for the  repo kind. FThe tag identify a particular state of the repository. This should be  given for the  repo kind and not for  kind. HSome repositories contain multiple projects in different subdirectories J This field specifies the subdirectory where this packages sources can be + found, eg the subdirectory containing the .cabal file. It is interpreted H relative to the root of the repository. This field is optional. If not  given the default is "." ie no subdirectory. component is buildable here tools needed to build this bit (options for pre-processing Haskell code options for C compiler options for linker "pkg-config packages that are used  support frameworks for Mac OS X /where to look for the haskell module hierarchy  non-exposed or non-main modules Lwhat libraries to link with when compiling a program that uses your package directories to find .h files (The .h files to be found in includeDirs %.h files to install with the package Custom fields starting  with x-, stored in a  simple assoc-list. %Is the lib to be exposed by default? /The type of build system used by this package. :a package that uses an unknown build type cannot actually 9 be built. Doing it this way rather than just giving a = parse error means we get better error messages and allows 7 you to inspect the rest of the package description. uses user-supplied Setup.hs or  Setup.lhs (default) calls Distribution.Make.defaultMain calls 9Distribution.Simple.defaultMainWithHooks defaultUserHooks,  which invokes  configure to generate additional build # information used by later phases. calls Distribution.Simple.defaultMain :This data type is the internal representation of the file  pkg.cabal. E It contains two kinds of information about the package: information M which is needed for all packages, such as the package name and version, and G information which is needed for the simple build system only, such as ( the compiler options and library name. #A one-line summary of this package +A more verbose description of this package Custom fields starting  with x-, stored in a  simple assoc-list. HIf this package depends on a specific version of Cabal, give that here. &does this package have any libraries? RS28 version of  AIf the package description has a library section, call the given 4 function with the library build info as argument. <Get all the module names from the libraries in this package (does this package have any executables? %Perform the action on each buildable  in the package  description. 7Get all the module names from the exes in this package The ( for the library (if there is one and it's buildable) and C all the buildable executables. Useful for gathering dependencies. 2Select options for a particular Haskell compiler. bcdefghijklmnopqrstuvwxyz{|}~{|}~uvwxyzstrbcdefmqponglkjihbcdefcdefglkjihhijklmqponnopqrsttuvwxyzvwxyz{|}~|}~ portablecabal-devel@haskell.org TJA map of dependencies. Newtyped since the default monoid instance is not * appropriate. The monoid instance uses '. U)Result of dependency test. Isomorphic to Maybe d but renamed for  clarity. V6Simplify the condition and return its free variables. WISimplify a configuration condition using the os and arch names. Returns : the names of all the flags occurring in the condition. /Parse a configuration condition from a string. XJTry to find a flag assignment that satisfies the constaints of all trees. CReturns either the missing dependencies, or a tuple containing the B resulting data, the associated dependencies, and the chosen flag  assignments. HIn case of failure, the _smallest_ number of of missing dependencies is B returned. [XXX: Could also be specified with a function argument.] LXXX: The current algorithm is rather naive. A better approach would be to: K Rule out possible paths, by taking a look at the associated dependencies. B Infer the required values for the conditions of these paths, and B calculate the required domains for the variables used in these J conditions. Then picking a flag assignment would be linear (I guess). <This would require some sort of SAT solving, though, thus it's not ' implemented unless we really need it. YBFlatten a CondTree. This will resolve the CondTree by taking all M possible paths into account. Note that since branches represent exclusive # choices this may not result in a "sane" result. ?Create a package description with all configurations resolved. This function takes a |{ and several environment " parameters and tries to generate  by finding a flag 5 assignment that result in satisfiable dependencies. FIt takes as inputs a not necessarily complete specifications of flags L assignments, an optional package index as well as platform parameters. If K some flags are not assigned explicitly, this function will try to pick an H assignment that causes this function to succeed. The package index is J optional since on some platforms we cannot determine which packages have M been installed before. When no package index is supplied, every dependency K is assumed to be satisfiable, therefore all not explicitly assigned flags  will get their default values. JThis function will fail if it cannot find a flag assignment that leads to I satisfiable dependencies. (It will not try alternative assignments for C explicitly specified flags.) In case of failure it will return a minimum J number of dependencies that could not be satisfied. On success, it will E return the package description and the full flag assignment chosen. JFlatten a generic package description by ignoring all conditions and just I join the field descriptors into on package description. Note, however, G that this may lead to inconsistent field values, since all values are J joined into one field, which may not be possible in the original package E description, due to the use of exclusive choices (if ... else ...). JXXX: One particularly tricky case is defaulting. In the original package J description, e.g., the source directory might either be the default or a L certain, explicitly set path. Since defaults are filled in only after the H package has been resolved and when no explicit value has been set, the L default path will be missing from the package description returned by this  function. portablecabal-devel@haskell.org AA record of operations needed to check the contents of packages.  Used by . .Results of some kind of failed package check. HThere are a range of severities, from merely dubious to totally insane. N All of them come with a human readable explanation. In future we may augment J them with more machine readable explanations, for example to help an IDE  suggest automatic corrections. !An issue that is ok in the author's environment but is almost D certain to be a portability problem for other environments. We can F quite legitimately refuse to publicly distribute packages with these  problems. @An issue that might not be a problem for the package author but E might be annoying or determental when the package is distributed to G users. We should encourage distributed packages to be free from these E issues, but occasionally there are justifiable reasons so we cannot  ban them entirely. ?A problem that is likely to affect building the package, or an  issue that we'4d like every package author to be aware of, even if # the package is never distributed. *This package description is no good. There' s no way it' s going to > build sensibly. This should give an error at configure time. @Check for common mistakes and problems in package descriptions. FThis is the standard collection of checks covering all apsects except H for checks that require looking at files within the package. For those  see . It requires the |{ and optionally a particular , configuration of that package. If you pass P28 then we just check , a version of the generic description using . Z-Check that this package description is sane. CSanity check things that requires IO. It looks at the files in the L package and expects to find the package unpacked in at the given filepath. CSanity check things that requires looking at files in the package. " This is a generalised version of  that can work in any ! monad for which you can provide  operations. LThe point of this extra generality is to allow doing checks in some virtual / file system, for example a tarball in memory. ICheck the names of all files in a package for portability problems. This K should be done for example when creating or validating a package tarball. [>Check a file name is valid for the portable POSIX tar format. JThe POSIX tar format has a restriction on the length of file names. It is I unfortunately not a simple restriction like a maximum length. The exact L restriction is that either the whole path be 100 characters or less, or it L be possible to split the path on a directory separator such that the first L part is 155 characters or less and the second part 100 characters or less. portablecabal-devel@haskell.org\6We parse generically based on indent level and braces '{' '}' . To do that  we split into lines and then '{' '}'' tokens and other spans within a line. ]#span in a line, following brackets ^The ^ token is for bits that start a line, eg:   "\n blah blah { blah" tokenises to:  : [Line n 2 False "blah blah", OpenBracket, Span n "blah"] Cso lines are the only ones that can have nested layout, since they ! have a known indentation level.  eg: we can' t have this:   if ... {  } else  other 6because other cannot nest under else, since else doesn't start a line ! so cannot have nested layout. It'd have to be:   if ... {  }  else  other but that'5s not so common, people would normally use layout or  brackets not both in a single if else construct.   if ... { foo : bar }  else  other  this is ok 2A conditional block with an optional else branch:   if  condition {   field*  } else {   field*  } =A section with a name and possible parameter. The syntactic  structure is:    sectionname> <arg {   field*  }  A regular  property>: <value field <The type of a function which, given a name-value pair of an > unrecognized field, and the current structure being built, 9 decides whether to incorporate the unrecognized field A (by returning Just x, where x is a possibly modified version A of the structure being built), or not (by returning Nothing). !Field descriptor. The parameter a# parameterizes over where the field's  value is stored in. fieldSet n str x- Parses the field value from the given input  string str and stores the result in x if the parse was 9 successful. Otherwise, reports an error on line number n. 'BA default unrecognized field parser which simply returns Nothing, H i.e. ignores all unrecognized fields, so warnings will be generated. (<A default unrecognized field parser which silently (i.e. no ? warnings will be generated) ignores unrecognized fields, by 3 returning the structure being built unmodified. _%Tokenise a single line, splitting on '{' '}' and the spans inbetween.  Also trims leading &0 trailing space on those spans within the line. `4Fix different systems silly line ending conventions a@Parse the stream of tokens into a tree of them, based on indent / layout b@Parse the stream of tokens into a tree of them, based on indent D This parse state expect to be in a layout context, though possibly J nested within a braces context so we may still encounter closing braces. cIParse the stream of tokens into a tree of them, based on explicit braces 5 This parse state expects to find a closing bracket. d*Convert the parse tree into the Field AST 3 Also check for dodgy uses of tabs in indentation. e Convert ifthenelse s to s ,parse a module name @GPretty-print free-format text, ensuring that it is vertically aligned, ? and with blank lines replaced by dots for correct re-parsing. E      !"#$%&'()*+,-./0123456789:;<=>?@E     *)#"+$%&-67,./20134589:=>?@< !;'(E         !"#$%&'()*+,-./0123456789:;<=>?@portablelibraries@haskell.org,   ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abc,BCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_A   `abc#ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_CDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abc;portablecabal-devel@haskell.orgfCThis is the InstalledPackageInfo type used by ghc-6.4.2 and later. It's here purely for the g23* instance so that we can read the package G database used by those ghc versions. It is a little hacky to read the J package db directly, but we do need the info and until ghc-6.9 there was  no better method. ;In ghc-6.4.1 and before the format was slightly different.  See Distribution.Simple.GHC.IPI642 hifjklmhifjklm<portablecabal-devel@haskell.orgnAThis is the InstalledPackageInfo type used by ghc-6.4 and 6.4.1. It's here purely for the g23* instance so that we can read the package G database used by those ghc versions. It is a little hacky to read the J package db directly, but we do need the info and until ghc-6.9 there was  no better method. +In ghc-6.4.2 the format changed a bit. See Distribution.Simple.GHC.IPI642 nonoportablecabal-devel@haskell.orgp Store any fields beginning with x- in the customFields field of D a PackageDescription. All other fields will generate a warning. q=Given a parser and a filename, return the parse of the file, $ after checking if the file exists. eParse the given package file. fParses the given file into a |{. IIn Cabal 1.2 the syntax for package descriptions was changed to a format < with sections and possibly indented property descriptions. r<Parse a list of fields, given a list of field descriptions, ? a structure to accumulate the parsed fields, and a function 3 that can decide what to do with fields which don' t match any  of the field descriptions. defghijkehfidgjkdefghijkportablecabal-devel@haskell.orgs)Common flags that apply to every command u!Long command line option strings v"Short command line option strings waAn OptionField takes one or more OptDescrs, describing the command line interface for the field. |CWe usually have a datatype for storing configuration values, where @ every field stores a configuration option, and the user sets D the value either via command line flags or a configuration file. A An individual OptionField models such a field, and we usually C build a list of options associated to a configuration datatype. DThe name of the command as it would be entered on the command line.  For example "build". CA short, one line description of the command to use in help texts. )The useage line summary for this command <Additional explanation of the command to use in help texts. Initial / empty flags 'All the Option fields for this command +Create an option taking a single OptDescr. P No explicit Name is given for the Option, the name is the first LFlag given. +Create an option taking several OptDescrs. ] You will have to give the flags and description individually to the OptDescr constructor. /Create a string-valued command line interface. DCreate a string-valued command line interface with a default value. (String -> a) variant of reqArg (String -> a) variant of optArg create a Choice option 3create a Choice option out of an enumeration type. O As long flags, the Show output is used. As short flags, the first character 8 which does not conflict with a previous one is used. uto view as a FieldDescr, we sort the list of interfaces (Req > Bool > Choice > Opt) and consider only the first one. ;Show flags in the standard long option command line format tEThe help text for this command with descriptions of all the options. Make a Command from standard GetOpt options. EUtility function, many commands do not accept additional flags. This K action fails with a helpful error message if the user supplies any extra. 3lmnopqrstuvwxyz{|}~3lmqpon|}~w{zyxvutsr3lmqponnopqrstuvw{zyxxyz{|}~}~portablecabal-devel@haskell.org?Some compilers support optimising. Some have different levels. A For compliers that do not the level is just capped to the level  they do support. BSome compilers have a notion of a database of available packages. C For some there is just one global db of packages, other compilers E support a per-user or an arbitrary db specified at some location in E the file system. This can be used to build isloated environments of A packages, for example to build a collection of related packages # without installing them globally. CFor the given compiler, return the extensions it does not support. GFor the given compiler, return the flags for the supported extensions. !TUVWXYZ[\]^_`aportablecabal-devel@haskell.org,The executable name; used in shell wrappers The cpu architecture name, eg i386 or x86_64 The operating system name, eg windows or linux "The compiler name and version, eg  ghc-6.6.1 The $pkgid package Id path variable, eg foo-1.0 The $version package version path variable The $pkg package name path variable The $htmldir path variable The $docdir path variable The  $datasubdir path variable The $datadir path variable The  $libsubdir path variable The $libdir path variable The $bindir path variable The $prefix path variable ?An abstract path, posibly containing variables that need to be  substituted for to get a real u24. The location prefix for the copy command. )The installation directories in terms of s that contain  variables. HThe defaults for most of the directories are relative to each other, in D particular they are all relative to a single prefix. This makes it H convenient for the user to override the default installation directory D by only having to specify --prefix=... rather than overriding each G individually. This is done by allowing $-style variables in the dirs. 0 These are expanded by textual substituion (see ). KA few of these installation directories are split into two components, the K dir and subdir. The full installation path is formed by combining the two  together with /7. The reason for this is compatibility with other unix " build systems which also support --libdir and  --datadir. We would like  users to be able to configure  --libdir=/usr/lib64 for example but G because by default we want to support installing multiple versions of M packages and building the same package for multiple compilers we append the  libsubdir to get: /usr/lib64/$pkgid/ $compiler. JAn additional complication is the need to support relocatable packages on 2 systems which support such things, like Windows. :The directories where we will install files for packages. IWe have several different directories for different types of files since M many systems have conventions whereby different types of files in a package J are installed in different direcotries. This is particularly the case on  unix style systems. v6Substitute the install dir templates into each other. DTo prevent cyclic substitutions, only some variables are allowed in J particular dir templates. If out of scope vars are present, they are not L substituted for. Checking for any remaining unsubstituted vars can be done  as a subsequent operation. -The reason it is done this way is so that in  we  can replace  with the  and get resulting  s that still have the  in them. Doing this makes it 8 each to check which paths are relative to the $prefix. EConvert from abstract install directories to actual absolute ones by G substituting for all the variables in the abstract paths, to get real  absolute path. CCheck which of the paths are relative to the installation $prefix. JIf any of the paths are not relative, ie they are absolute paths, then it @ prevents us from making a relocatable package (also known as a "prefix  independent" package).  Convert a u24 to a  including any template vars. 8Convert back to a path, any remaining vars are included >The initial environment has all the static stuff but no paths ///portablecabal-devel@haskell.org" Flags to register and  unregister: (user package, gen-script,  in-place, verbosity)  Flags to sdist: (snapshot, verbosity)  Flags to install: (package db, verbosity)  Flags to copy7: (destdir, copy-prefix (backwards compat), verbosity) # Flags to  configure command % All programs that cabal may run &user specifed programs paths 'user specifed programs args (The "flavor"' of the compiler, sugh as GHC or Hugs. )given compiler location *given hc-pkg location +Enable vanilla library , Enable profiling in the library -Build shared library .%Enable profiling in the executables. /Extra arguments to  configure 0Enable optimization. 1Installed executable prefix. 2Installed executable suffix. 3Installation paths 5#path to search for extra libraries 6 path to search for header files 7dist prefix 8verbosity level 9 The --user/--global flag :Which package DB to use ;"Enable compiling library for GHCi <Enable -split-objs with GHC =Enable executable stripping >Additional constraints for  dependencies @;Flags that apply at the top level, not to any sub-command. D2All flags are monoids, they come in two flavours: 1. list flags eg  # --ghc-option=foo --ghc-option=bar gives us all the values [foo, bar] 2. singular value flags, eg:   --enable-foo --disable-foo gives us Just False < So this Flag type is for the latter singular kind of flag. C Its monoid instance gives us the behaviour where it starts out as  E( and later flags override earlier ones. zArguments to pass to a  configure script, e.g. generated by  autoconf. w<Helper function to split a string into a list of arguments.  It'1s supposed to handle quoted things sensibly, eg: 2 splitArgs "--foo=\"C:\Program Files\Bar\" --baz" - = ["--foo=C:\Program Files\Bar", "--baz"]       !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz@ABCOMN#$%&'()*+,-./0123456789:;<=>?TPQ !"WUVZXYgefbcdnlmkjhiqop     a^_`][\trszRSGDFEHIJKLuvwxy            !" !"#$%&'()*+,-./0123456789:;<=>?$%&'()*+,-./0123456789:;<=>?@ABCABCDFEEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyzportablecabal-devel@haskell.org!=>?@KLMNOPQRS{|} KSRQPONML{|}{|}portablecabal-devel@haskell.org~0Data cached after configuration step. See also  Distribution.Setup.ConfigFlags. 6The installation directories for the various differnt  kinds of files The compiler we're building with Where to build the package. +Where to put the result of the Hugs build. Which packages we depend on, exactly.  The  ' specifies a set of build dependencies : that must be satisfied in terms of version ranges. This 9 field fixes those dependencies to the specific versions . available on this machine for this compiler. +All the info about all installed packages. 6the filename containing the .cabal file, if available 8The resolved package description, that does not contain  any conditionals. #Location and args for all programs $What package database to use, global/user Whether to build normal libs. -Whether to build profiling versions of libs. *Whether to build shared versions of libs. ,Whether to build executables for profiling. 3Whether to build with optimization (if available). 2Whether to build libs suitable for use with GHCi. 'Use -split-objs with GHC, if available ,Whether to strip executables during install 0Prefix to be prepended to installed executables /Suffix to be appended to installed executables See  See  E~~~portablecabal-devel@haskell.orgportablecabal-devel@haskell.org5The directory in which we put auto-generated modules @The name of the auto-generated module associated with a package Extension for executable files  (typically "" on Unix and "exe" on Windows or OS/2) =Extension for object files. For GHC and NHC the extension is "o".  Hugs uses either "o" or "obj"# depending on the used C compiler. 7Extension for dynamically linked (or shared) libraries  (typically "so" on Unix and "dll" on Windows) GG portablecabal-devel@haskell.orgportablecabal-devel@haskell.org xGiven something like usrlocalbin"ghc-6.6.1(.exe) we try and find a L corresponding ghc-pkg, we try looking for both a versioned and unversioned # ghc-pkg in the same dir, that is: $ /usr/local/bin/ghc-pkg-6.6.1(.exe)  /usr/local/bin/ghc-pkg(.exe) y0Adjust the way we find and configure gcc and ld zJFor GHC 6.6.x and earlier, the mapping from supported extensions to flags {;Get the packages from specific PackageDBs, not cumulative. @Building for GHC. If .ghc-packages exists and is readable, add  it to the command-line. | Filter the  -threaded$ flag when profiling as it does not  work with ghc-6.8 and older. Install executables for GHC. 7Install for ghc, .hi, .a and, if --with-ghci given, .o }use ranlib or ar -s1 to build an index. This is necessary on systems  like MacOS X. If we can't find those, don't worry too much about it.  portablecabal-devel@haskell.org~'The flags for the supported extensions Building a package for JHC. - Currently C source files are not supported. !portablecabal-devel@haskell.org'The flags for the supported extensions ?FIX: For now, the target must contain a main module. Not used  ATM. Re-add later. Install executables for GHC. $Install for nhc98: .hi and .a files "portablecabal-devel@haskell.orgFA preprocessor for turning non-Haskell files with the given extension " into plain Haskell source files. CThe interface to a preprocessor, which may be implemented using an C external program, but need not be. The arguments are the name of D the input file, the name of the output file and a verbosity level. F Here is a simple example that merely prepends a comment to the given  source file:   ppTestHandler :: PreProcessor  ppTestHandler =  PreProcessor { ! platformIndependent = True, K runPreProcessor = mkSimplePreProcessor $ \inFile outFile verbosity -> I do info verbosity (inFile++" has been preprocessed to "++outFile) # stuff <- readFile inFile G writeFile outFile ("-- preprocessed as a test\n\n" ++ stuff)  return ExitSuccess GWe split the input and output file names into a base directory and the M rest of the file name. The input base dir is the path in the list of search N dirs that this file was found in. The output base dir is the build dir where ) all the generated source files are put. GThe reason for splitting it up this way is that some pre-processors don't B simply generate one output .hs file from one input file but have J dependencies on other genereated files (notably c2hs, where building one K .hs file may require reading other .chi files, and then compiling the .hs M file may require reading a generated .h file). In these cases the generated M files need to embed relative path names to each other (eg the generated .hs N file mentions the .h file in the FFI imports). This path must be relative to I the base directory where the genereated files are located, it cannot be J relative to the top level of the build tree because the compilers do not 7 look for .h files relative to there, ie we do not use "-I ." , instead we  use "-I dist/build"1 (or whatever dist dir has been set by the user) GMost pre-processors do not care of course, so mkSimplePreProcessor and 9 runSimplePreProcessor functions handle the simple case. (Apply preprocessors to the sources from  , to obtain ( a Haskell source file for each module. DFind the first extension of the file that exists, and preprocess it  if required. ?Convenience function; get the suffixes of these preprocessors. HStandard preprocessors: GreenCard, c2hs, hsc2hs, happy, alex and cpphs. #portablecabal-devel@haskell.org'The flags for the supported extensions Building a package for Hugs. ARead the initial part of a source file, before any Haskell code, G and return the contents of any LANGUAGE, OPTIONS and INCLUDE pragmas. $Strip comments from Haskell source. Install for Hugs. 5 For install, copy-prefix = prefix, but for copy they're different.  The library goes in < copy-prefix>/lib/hugs/packages/< pkgname>  (i.e. <prefix>/lib/hugs/packages/< pkgname> on the target system).  Each executable goes in < copy-prefix>/lib/hugs/programs/< exename>  (i.e. <prefix>/lib/hugs/programs/<exename> on the target system)  with a script < copy-prefix>/bin/<exename> pointing at  <prefix>/lib/hugs/programs/< exename>. <Filename used by Hugs for the main module of an executable. E This is a simple filename, so that Hugs will look for any auxiliary - modules it uses relative to the directory it's in. $portablecabal-devel@haskell.org5Build the libraries and executables in this package. !Generate and write out the Paths_ pkg.hs and cabal_macros.h files %portablecabal-devel@haskell.org&portablecabal-devel@haskell.org Perform the "./ setup install" and "./ setup copy" E actions. Move files into place based on the prefix argument. FIX:  nhc isn't implemented yet. -Install the files listed in install-includes 'portablecabal-devel@haskell.orgRegister doesn'4t drop the register info file, it must be done in a  separate step. DCreate a string suitable for writing out to the package config file ALike rawSystemProgram, but emits to a script instead of exiting.  FIX: chmod +x? ELike rawSystemEmit, except it has string for pipeFrom. FIX: chmod +x (portablecabal-devel@haskell.org  Read the (. Error if it doesn't exist. Also E fail if the file containing LocalBuildInfo is older than the .cabal 3 file, indicating that a re-configure is required. Try to read the (. $After running configure, output the ~ to the  (. @Check that localBuildInfoFile is up-to-date with respect to the  .cabal file.  dist/ setup-config Perform the "./setup configure" action.  Returns the  .setup-config file. BConverts build dependencies to a versioned dependency. only sets 7 version information for exact versioned dependencies. HTest for a package dependency and record the version we have installed. Makes a # from C compiler and linker flags. MThis can be used with the output from configuration programs like pkg-config O and similar package-specific programs like mysql-config, freealut-config etc.  For example: H ccflags <- rawSystemProgramStdoutConf verbosity prog conf ["--cflags"] F ldflags <- rawSystemProgramStdoutConf verbosity prog conf ["--libs"] ? return (ccldOptionsBuildInfo (words ccflags) (words ldflags)) >Output package check warnings and errors. Exit if any errors.   )portablecabal-devel@haskell.org Create a source distribution. *Prepare a directory tree of source files. APrepare a directory tree of source files for a snapshot version. K It is expected that the appropriate snapshot version has already been set & in the package description, eg using ) or ).  Modifies a  by appending a snapshot number " corresponding to the given date.  Modifies a @27. by appending a snapshot number corresponding  to the given date. =Given a date produce a corresponding integer representation.  For example given a date 18032008 produce the number 20080318. FCreate an archive from a tree of source files, and clean up the tree. /Move the sources into place based on buildInfo *The name of the tarball without extension *portablecabal-devel@haskell.org'EHooks allow authors to add specific functionality before and after a ? command is run, and also to specify additional preprocessors. I WARNING: The hooks interface is under rather constant flux as we try to G understand users needs. Setup files that depend on this interface may  break in future releases.  Used for ./ setup test Read the description file 3Custom preprocessors in addition to and overriding knownSuffixHandlers. GThese programs are detected at configure time. Arguments for them are ! added to the configure command. %Hook to run before configure command @Over-ride this hook to get different behavior during configure. $Hook to run after configure command IHook to run before build command. Second arg indicates verbosity level. =Over-ride this hook to gbet different behavior during build. HHook to run after build command. Second arg indicates verbosity level. LHook to run before makefile command. Second arg indicates verbosity level. ?Over-ride this hook to get different behavior during makefile. KHook to run after makefile command. Second arg indicates verbosity level. IHook to run before clean command. Second arg indicates verbosity level. <Over-ride this hook to get different behavior during clean. HHook to run after clean command. Second arg indicates verbosity level.  Hook to run before copy command ;Over-ride this hook to get different behavior during copy. Hook to run after copy command #Hook to run before install command >Over-ride this hook to get different behavior during install. ;Hook to run after install command. postInst should be run * on the target, not on the build machine. IHook to run before sdist command. Second arg indicates verbosity level. <Over-ride this hook to get different behavior during sdist. HHook to run after sdist command. Second arg indicates verbosity level. $Hook to run before register command  COver-ride this hook to get different behavior during registration.  #Hook to run after register command  &Hook to run before unregister command  COver-ride this hook to get different behavior during registration.  %Hook to run after unregister command LHook to run before hscolour command. Second arg indicates verbosity level. ?Over-ride this hook to get different behavior during hscolour. KHook to run after hscolour command. Second arg indicates verbosity level. KHook to run before haddock command. Second arg indicates verbosity level. >Over-ride this hook to get different behavior during haddock. JHook to run after haddock command. Second arg indicates verbosity level. Empty ** which do nothing. )     )     )&          +portablecabal-devel@haskell.orgA simple implementation of main for a Cabal setup script. B It reads the package description file using IO, and performs the ' action specified on the command line.  A version of +! that is passed the command line ; arguments, rather than getting them from the environment. A customizable version of +. A customizable version of + that also takes the command  line arguments. Like +/, but accepts the package description as input " rather than using IO to read it. 6Combine the preprocessors in the given hooks with the ! preprocessors built into cabal. 6Hooks that correspond to a plain instantiation of the  "simple" build system Basic autoconf ++:  on non-Windows systems, + runs ./ configure, if present.  the pre-hooks +, +, +, +,  + and  +( read additional build information from  package .buildinfo, if present. Thus  configure. can use local system information to generate  package .buildinfo and possibly other files. =>?@&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnoKLMNOPQRSTUVWXYZ[\]^_`a     2     =>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~                                            ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C C D E F G H I I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~        !"#$%&'()*++,-./01232456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijiklmnopqrstuvwxyz{|}~M       !"##$%&'())*+,-./0123456789:;<=>?@ABCDEEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~~     !!!!""""""""""""""""""###$$$$%%&'''''((((((((((((())))))))*****************************************+{+|+++}+++,-2.. . . 24 24 /0000011111111111112 !27"27#27$27$%23&'( ) *24+ , -25. / 0 126232849:5628789:;<=>?@ABCDEFGHI;i2JK;;;L;M;N;O<i<OPQNRS2TUVWXYZ[\] ^!_"`#a#b#c#d&e'f'g'h(i(j)k)l+mn Cabal-1.6.0.2Distribution.Compat.ReadPDistribution.TextDistribution.VersionLanguage.Haskell.ExtensionDistribution.System$Distribution.Simple.PreProcess.UnlitDistribution.ReadEDistribution.VerbosityDistribution.PackageDistribution.ModuleNameDistribution.Simple.Utils Distribution.Simple.PackageIndexDistribution.Simple.ProgramDistribution.LicenseDistribution.CompilerDistribution.PackageDescription-Distribution.PackageDescription.Configuration%Distribution.PackageDescription.CheckDistribution.ParseUtils!Distribution.InstalledPackageInfo%Distribution.PackageDescription.ParseDistribution.Simple.CommandDistribution.Simple.CompilerDistribution.Simple.InstallDirsDistribution.Simple.SetupDistribution.Make"Distribution.Simple.LocalBuildInfo Distribution.Simple.Build.MacrosDistribution.Simple.BuildPaths%Distribution.Simple.Build.PathsModuleDistribution.Simple.GHCDistribution.Simple.JHCDistribution.Simple.NHCDistribution.Simple.PreProcessDistribution.Simple.HugsDistribution.Simple.BuildDistribution.Simple.HaddockDistribution.Simple.InstallDistribution.Simple.RegisterDistribution.Simple.ConfigureDistribution.Simple.SrcDistDistribution.Simple.UserHooksDistribution.Simple Distribution.Simple.GHC.MakefileDistribution.Compat.PermissionsDistribution.Compat.ExceptionDistribution.Compat.TempFileDistribution.Compat.CopyFileDistribution.GetOptbase Text.Read System.IO Data.Monoid Control.Monad Data.Version Data.Maybeghc-primGHC.BoolDistribution.Simple.GHC.IPI642Distribution.Simple.GHC.IPI641ReadPgetlookpfail+++<++gathersatisfycharstringmunchmunch1choice skipSpacescountbetweenoptionoptionalmanymany1skipMany skipMany1sepBysepBy1endByendBy1chainrchainlchainr1chainl1manyTill readP_to_S readS_to_PTextdispparsedisplay simpleParse VersionRangeIntersectVersionRangesUnionVersionRangesEarlierVersion LaterVersion ThisVersion AnyVersion isAnyVersionnotThisVersionorLaterVersionorEarlierVersionbetweenVersionsInclusive withinRange ExtensionUnknownExtension ViewPatternsTransformListComp QuasiQuotesPostfixOperatorsNewQualifiedOperatorsImpredicativeTypesPackageImportsConstrainedClassMethodsDeriveDataTypeable UnboxedTuplesExtendedDefaultRulesRelaxedPolyRecNoMonoPatBindsGADTsOverloadedStringsDisambiguateRecordFields RecordPunsRecordWildCards TypeOperatorsLiberalTypeSynonymsUnliftedFFITypesPatternSignatures UnicodeSyntaxStandaloneDeriving TypeFamilies MagicHash HereDocumentsRestrictedTypeSynonymsExtensibleRecordsGeneralizedNewtypeDeriving PatternGuardsNamedFieldPunsNoImplicitPreludeGenericsArrowsForeignFunctionInterfaceTemplateHaskellTypeSynonymInstances BangPatternsKindSignaturesCPPEmptyDataDeclsFlexibleInstancesFlexibleContextsImplicitParamsScopedTypeVariablesExistentialQuantificationPolymorphicComponents RankNTypes Rank2TypesFunctionalDependenciesNoMonomorphismRestrictionMultiParamTypeClassesParallelListComp RecursiveDoIncoherentInstancesUndecidableInstancesOverlappingInstancesknownExtensionsPlatformArch OtherArchVaxM68kRs6000HppaAlphaS390IA64SHMipsArmSparcPPC64PPCX86_64I386OSOtherOSIRIXHPUXAIXSolarisNetBSDOpenBSDFreeBSDOSXWindowsLinuxbuildOS buildArch buildPlatformplainunlitReadErunReadE succeedReadE failReadE parseReadE readEOrFail readP_to_E Verbositysilentnormalverbose deafening moreVerbose lessVerboseintToVerbosityflagToVerbosity showForCabal showForGHCPackageFixedDepsdependsPackage packageId DependencyPackageIdentifierpkgName pkgVersion PackageId PackageNamethisPackageVersionnotThisPackageVersion packageNamepackageVersion ModuleNamesimplemain components toFilePath cabalVersioncabalBootstrappingdieWithLocationdiewarnnotice setupMessageinfodebug chattyTrywrapTextwrapLine maybeExit rawSystemExitrawSystemStdoutrawSystemStdout'xargsfindFilefindFileWithExtensionfindFileWithExtension' matchFileGlobmatchDirFileGlobsmartCopySourcescreateDirectoryIfMissingVerbosecopyFileVerbose copyFilescopyDirectoryRecursiveVerbose withTempFilewithTempDirectorywithFileContentswriteFileAtomic rewriteFile currentDirdefaultPackageDescfindPackageDescdefaultHookedPackageDescfindHookedPackageDescfromUTF8toUTF8 readUTF8FilewithUTF8FileContents writeUTF8Fileequating comparing isInfixOf intercalate lowercase SearchResult Ambiguous UnambiguousNone PackageIndexfromListmergeinsertdeletePackageIddeletePackageNamedeleteDependency allPackagesallPackagesByNamelookupPackageIdlookupPackageNamelookupDependency searchByNamesearchByNameSubstringbrokenPackagesdependencyClosurereverseDependencyClosuretopologicalOrderreverseTopologicalOrderdependencyInconsistenciesdependencyCyclesdependencyGraphProgramConfigurationProgramLocation FoundOnSystem UserSpecified locationPathConfiguredProgram programIdprogramVersion programArgsprogramLocationProgArgProgram programNameprogramFindLocationprogramFindVersionprogramPostConf programPath simpleProgramfindProgramOnPathfindProgramVersionemptyProgramConfigurationdefaultProgramConfigurationrestoreProgramConfigurationaddKnownProgramaddKnownProgramslookupKnownProgram knownProgramsuserSpecifyPathuserMaybeSpecifyPathuserSpecifyArgsuserSpecifyPathsuserSpecifyArgssuserSpecifiedArgs lookupProgram updateProgramconfigureProgramconfigureAllKnownProgramsreconfigureProgramsrequireProgramrawSystemProgramrawSystemProgramStdoutrawSystemProgramConfrawSystemProgramStdoutConfbuiltinPrograms ghcProgram ghcPkgProgram nhcProgram hmakeProgram jhcProgram hugsProgramffihugsProgram happyProgram alexProgram gccProgram ranlibProgram arProgram stripProgram hsc2hsProgram c2hsProgram cpphsProgramhscolourProgramhaddockProgramgreencardProgram ldProgram tarProgram cppProgrampkgConfigProgramLicenseUnknownLicense OtherLicenseAllRightsReserved PublicDomainBSD4BSD3LGPLGPL CompilerIdCompilerFlavor OtherCompilerJHCHeliumHBCHugsYHCNHCGHCparseCompilerFlavorCompatbuildCompilerFlavordefaultCompilerFlavorCondTreeCondNode condTreeDatacondTreeConstraintscondTreeComponents ConditionCAndCOrCNotLitVarConfVarImplFlagFlagAssignmentFlagNameMkFlagflagNameflagDescription flagDefault flagManualGenericPackageDescriptionpackageDescriptiongenPackageFlags condLibrarycondExecutablesRepoType OtherRepoTypeMonotoneBazaarGnuArch MercurialCVSSVNGitDarcsRepoKindRepoKindUnknownRepoThisRepoHead SourceReporepoKindrepoType repoLocation repoModule repoBranchrepoTag repoSubdirHookedBuildInfo BuildInfo buildable buildTools cppOptions ccOptions ldOptionspkgconfigDepends frameworkscSources hsSourceDirs otherModules extensions extraLibs extraLibDirs includeDirsincludesinstallIncludesoptionsghcProfOptionsghcSharedOptionscustomFieldsBI ExecutableexeName modulePath buildInfoLibraryexposedModules libExposed libBuildInfo BuildTypeUnknownBuildTypeCustomMake ConfigureSimplePackageDescriptionpackagelicense licenseFile copyright maintainerauthor stability testedWithhomepagepkgUrl bugReports sourceRepossynopsis descriptioncategorycustomFieldsPD buildDependsdescCabalVersion buildTypelibrary executables dataFilesdataDir extraSrcFiles extraTmpFilesemptyPackageDescriptionknownBuildTypes emptyLibraryhasLibswithLib libModulesemptyExecutablehasExeswithExe exeModulesemptyBuildInfo allBuildInfoemptyHookedBuildInfo hcOptionsupdatePackageDescriptionparseConditionfreeVarsfinalizePackageDescriptionflattenPackageDescriptionCheckPackageContentOps doesFileExistdoesDirectoryExist PackageCheckPackageDistInexcusablePackageDistSuspiciousPackageBuildWarningPackageBuildImpossible explanation checkPackagecheckConfiguredPackagecheckPackageFilescheckPackageContentcheckPackageFileNamesFieldIfBlockSectionFUnrecFieldParser FieldDescr fieldNamefieldGetfieldSet ParseResultParseOk ParseFailedPWarning UTFWarningPError FromString TabsErrorNoParse AmbigousParseLineNo showPWarningcatchParseError parseFailrunPrunElocatedErrorMsg syntaxErrorwarningfield liftField simpleFieldcommaListFieldspaceListField listField optsField boolFieldppFieldsppField showFieldsshowSingleNamedField parseFields warnUnrec ignoreUnreclineNofName readFieldsparseModuleNameQparseFilePathQparseBuildToolparsePkgconfigDependencyparsePackageNameQparseVersionRangeQparseOptVersionparseTestedWithQ parseLicenseQparseExtensionQ parseTokenQ parseTokenQ' parseSepListparseCommaListparseOptCommaList parseQuoted parseFreeText showFilePath showTokenshowTestedWith showFreeTextInstalledPackageInfoInstalledPackageInfo_exposed hiddenModules importDirs libraryDirs hsLibrariesextraLibrariesextraGHCiLibraries hugsOptions frameworkDirshaddockInterfaces haddockHTMLsemptyInstalledPackageInfoparseInstalledPackageInfoshowInstalledPackageInfoshowInstalledPackageInfoFieldreadHookedBuildInforeadPackageDescriptionparsePackageDescriptionparseHookedBuildInfowritePackageDescriptionshowPackageDescriptionwriteHookedBuildInfoshowHookedBuildInfoCommand CommandParseCommandReadyToGo CommandErrors CommandList CommandHelp MkOptDescrArgPlaceHolderOptFlagsLFlagsSFlagsOptDescrBoolOpt ChoiceOptOptArgReqArg OptionField optionName optionDescr DescriptionNameShowOrParseArgs ParseArgsShowArgs CommandUI commandNamecommandSynopsis commandUsagecommandDescriptioncommandDefaultFlagscommandOptions multiOptionreqArgoptArgreqArg'optArg'noArgboolOptboolOpt' choiceOptchoiceOptFromEnumviewAsFieldDescr liftOptioncommandShowOptions makeCommandcommandAddAction commandsRun noExtraFlagsOptimisationLevelMaximumOptimisationNormalOptimisationNoOptimisation PackageDBSpecificPackageDB UserPackageDBGlobalPackageDBCompiler compilerIdcompilerExtensionsshowCompilerIdcompilerFlavorcompilerVersionflagToOptimisationLevelunsupportedExtensionsextensionsToFlagsPathTemplateVariableExecutableNameVarArchVarOSVar CompilerVarPkgIdVar PkgVerVar PkgNameVar HtmldirVar DocdirVar DatasubdirVar DatadirVar LibsubdirVar LibdirVar BindirVar PrefixVar PathTemplateCopyDest CopyPrefixCopyTo NoCopyDestInstallDirTemplates InstallDirsprefixbindirlibdir libsubdir dynlibdir libexecdirprogdir includedirdatadir datasubdirdocdirmandirhtmldir haddockdircombineInstallDirsdefaultInstallDirsabsoluteInstallDirsprefixRelativeInstallDirstoPathTemplatefromPathTemplatesubstPathTemplateinitialPathTemplateEnvfullPathTemplateEnv TestFlags testDistPref testVerbosity MakefileFlags makefileFilemakefileDistPrefmakefileVerbosity BuildFlagsbuildProgramPathsbuildProgramArgs buildDistPrefbuildVerbosity CleanFlags cleanSaveConf cleanDistPrefcleanVerbosity HaddockFlagshaddockProgramPathshaddockProgramArgs haddockHooglehaddockHtmlLocationhaddockExecutableshaddockInternal haddockCsshaddockHscolourhaddockHscolourCsshaddockDistPrefhaddockVerbosity HscolourFlags hscolourCSShscolourExecutableshscolourDistPrefhscolourVerbosity RegisterFlags regPackageDB regGenScript regGenPkgConf regInPlace regDistPref regVerbosity SDistFlags sDistSnapshot sDistDistPrefsDistVerbosity InstallFlagsinstallPackageDBinstallDistPrefinstallUseWrapperinstallInPlaceinstallVerbosity CopyFlagscopyDest copyDistPrefcopyUseWrapper copyInPlace copyVerbosity ConfigFlagsconfigProgramsconfigProgramPathsconfigProgramArgsconfigHcFlavor configHcPath configHcPkgconfigVanillaLib configProfLibconfigSharedLib configProfExeconfigConfigureArgsconfigOptimizationconfigProgPrefixconfigProgSuffixconfigInstallDirsconfigScratchDirconfigExtraLibDirsconfigExtraIncludeDirsconfigDistPrefconfigVerbosityconfigUserInstallconfigPackageDB configGHCiLibconfigSplitObjsconfigStripExesconfigConstraintsconfigConfigurationsFlags GlobalFlags globalVersionglobalNumericVersionNoFlagdefaultDistPreftoFlagfromFlagfromFlagOrDefault flagToMaybe flagToListdefaultGlobalFlags globalCommandemptyGlobalFlagsdefaultConfigFlagsconfigureCommandconfigureOptionsinstallDirsOptionsemptyConfigFlagsdefaultCopyFlags copyCommandemptyCopyFlagsdefaultInstallFlagsinstallCommandemptyInstallFlagsdefaultSDistFlags sdistCommandemptySDistFlagsdefaultRegisterFlagsregisterCommandunregisterCommandemptyRegisterFlagsemptyHscolourFlagsdefaultHscolourFlagshscolourCommanddefaultHaddockFlagshaddockCommandemptyHaddockFlagsdefaultCleanFlags cleanCommandemptyCleanFlags buildVerbosedefaultBuildFlags buildCommandemptyBuildFlagsdefaultMakefileFlagsmakefileCommandemptyMakefileFlagsdefaultTestFlags testCommandemptyTestFlagstrueArgfalseArgoptionVerbosity configureArgs defaultMaindefaultMainArgsdefaultMainNoReadLocalBuildInfoinstallDirTemplatescompilerbuildDir scratchDir packageDeps installedPkgs pkgDescrFile localPkgDescr withPrograms withPackageDBwithVanillaLib withProfLib withSharedLib withProfExewithOptimization withGHCiLib splitObjs stripExes progPrefix progSuffixgeneratesrcPref hscolourPref haddockPrefautogenModulesDir cppHeaderNameautogenModuleName haddockName mkLibName mkProfLibNamemkSharedLibName exeExtension objExtension dllExtension configuregetInstalledPackagesbuildghcVerbosityOptions ghcOptionsmakefile installExe installLibPPSuffixHandler PreProcessorplatformIndependentrunPreProcessormkSimplePreProcessorrunSimplePreProcessorpreprocessSources ppGreenCardppUnlitppCppppCpp'ppHsc2hsppC2hsppHappyppAlex ppSuffixesknownSuffixHandlersinstallinitialBuildStepswriteAutogenFileshaddockhscolourregisterwriteInstalledConfigremoveInstalledConfigremoveRegScripts unregistertryGetConfigStateFilegetPersistBuildConfigmaybeGetPersistBuildConfigwritePersistBuildConfigcheckPersistBuildConfiglocalBuildInfoFileconfigDependencyccLdOptionsBuildInfoconfigCompilerAuxconfigCompilercheckForeignDepssdist prepareTreeprepareSnapshotTreesnapshotPackagesnapshotVersiondateToSnapshotNumber createArchiveprintPackageProblems UserHooksrunTestsreadDeschookedPreProcessorshookedProgramspreConfconfHookpostConfpreBuild buildHook postBuild preMakefile makefileHook postMakefilepreClean cleanHook postCleanpreCopycopyHookpostCopypreInstinstHookpostInstpreSDist sDistHook postSDistpreRegregHookpostRegpreUnreg unregHook postUnreg preHscolour hscolourHook postHscolour preHaddock haddockHook postHaddockArgsemptyUserHooksdefaultMainWithHooksdefaultMainWithHooksArgssimpleUserHooksdefaultUserHooksautoconfUserHooksmakefileTemplatecopyPermissionsControl.Exception.BasebracketOnError onException throwIOIOcatchIO catchExitopenBinaryTempFile openTempFileopenNewBinaryFilecopyOrdinaryFilecopyExecutableFilesetFileOrdinarysetFileExecutablecopyFileArgDescrNoArgOptionArgOrder ReturnInOrderPermute RequireOrder usageInfogetOptgetOpt'Text.ParserCombinators.ReadPReadS wildcardRangeisWildcardRange versionTags versionBranchVersionclassifyExtensionreadClassificationStrictnessCompatFileGlobNoGlobreadFilelookup mergeBucketsmappenddeleteuserSpecifiedPathconfigureProgramsfoldMclassifyCompilerFlavorNothingBool maybeHasLibsMaybe DependencyMap DepTestRsltsimplifyConditionsimplifyWithSysParamsresolveWithFlagsignoreConditions checkSanity checkTarPathTokenSpanLine tokeniseLinenormaliseLineEndingsmkTreelayoutbracesmkFieldifelseGHC.ReadReadconvertPackageIdconvertModuleNameconvertLicense toCurrentstoreXFieldsPDreadAndParseFile CommonFlag commandHelp GHC.IOBaseFilePathsubstituteTemplates splitArgsguessGhcPkgFromGhcPathconfigureToolchainoldLanguageExtensionsgetInstalledPackages'hackThreadedFlagupdateLibArchivejhcLanguageExtensionsnhcLanguageExtensionspreprocessModulehugsLanguageExtensionsgetOptionsFromSource stripCommentshugsMainFilenameinstallIncludeFilesshowInstalledConfig rawSystemEmit rawSystemPipeinventBogusPackageIdcheckPackageProblems prepareDir tarBallNameallSuffixHandlers