=֦      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTU 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 { | } ~                                 !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~      !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGH 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"{"|"}"~""""""""""""""""########################################################################################################################### # # # # ################### #!#"###$#%#&#'#(#)#*#+#,#-#.#/$0$1$2%3%4%5%6%7%8%9%:%;%<%=%>%?%@%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%[%\%]%^%_%`%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({(|(})~)))))*++,,,,,,,,,,,,,,,,,,,,,,,,------------------.........................................////////0000001111111111112222222223333333444556 6 6 6 6 6666666788888888@9  !"#$%&'#$%&'#$%&'portablecabal-devel@haskell.orgA is a wrapper for pure and impure tests so that lists containing * arbitrary test types can be constructed. ()JClass abstracting pure tests. Test frameworks should prefer to implement  this class over .. A default instance exists so that any pure I test can be lifted into an impure test; when lifted, any exceptions are I automatically caught. Test agents that lift pure tests themselves must  handle exceptions. The result of a pure test. GClass abstracting impure tests. Test frameworks should implement this C class only as a last resort for test types which actually require *. N In particular, tests that simply require pseudo-random number generation can  be implemented as pure tests. =Runs an impure test and returns the result. Test frameworks J implementing this class are responsible for converting any exceptions to  the correct   value. #indicates a test that could not be 1 completed due to some error; the test framework ) should provide a message indicating the  nature of the error. +indicates a test completed unsuccessfully;  the +* value should be a human-readable message ! indicating how the test failed. indicates a successful test The name of the test. 7A list of the options a test recognizes. The name and , are I provided so that test agents can ensure that user-specified options are  correctly typed. FThe default options for a test. Test frameworks should provide a new  random seed, if appropriate. CTry to parse the provided options. Return the names of unparsable I options. This allows test agents to detect bad user-specified options. < are provided to pass options to test runners, making tests ! reproducable. Each option is a (+, +) of the form   (Name, Value). Use - to combine sets of ; if the same G option is given different values, the value from the left argument of  - will be used. )Read an option from the specified set of . It is an error to M lookup an option that has not been specified. For this reason, test agents  should - any  against the  for a test, so H the default value specified by the test framework will be used for any  otherwise-unspecified options. 3A convenient function for wrapping pure tests into s. 5A convenient function for wrapping impure tests into s.      portablecabal-devel@haskell.org./01234567No unliteration. 89: takes a filename (for error reports), and transforms the K given string, to eliminate the literate comments from the program text. :;<:portablelibraries@haskell.org=>?@ABC@Describes whether an option takes an argument or not, and if so 3 how the argument is injected into a value of type a. Doptional argument Eoption requires argument Fno argument expected GEach G describes a single option. The arguments to H are: ! list of short option characters & list of long option strings (without "--")  argument descriptor  explanation of option for user HI.What to do with options following non-options Jwrap non-options into options K+freely intersperse options and non-options L,no option processing after first non-option M@Return a string describing the usage of a command, derived from > the header (first argument) and the options described by the  second argument. NOPQREProcess the command-line, and return the list of values that matched (and those that didn't). The arguments are:  The order requirements (see I)  The option descriptions (see G) 8 The actual command line arguments (presumably got from  System.Environment.getArgs). R= returns a triple consisting of the option arguments, a list .of non-options, and a list of error messages. SThis is almost the same as R, 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. TUVWXYZ CDEFGHIJKLMRS CFEDDEFGHHILKJJKLMRS;[\]^_`[\]^_[\]^_<abcdefghiafaf=jklmnjkmnjkmnportablelibraries@haskell.org+opqrstuvwx)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. 0Like ., but discards the result. 1Like /, but discards the result. 2 sepBy p sep$ parses zero or more occurrences of p, separated by sep. ( Returns a list of values returned by p. 3 sepBy1 p sep# parses one or more occurrences of p, separated by sep. ( Returns a list of values returned by p. 4 endBy p sep$ parses zero or more occurrences of p, separated and ended  by sep. 5 endBy p sep# parses one or more occurrences of p, separated and ended  by sep. 6 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. 7 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. 8Like 6(, but parses one or more occurrences of p. 9Like 7(, 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. " !"#$%&'()*+,-./0123456789:;<" !"#$%&')(*+,-./0123456798:;<! !"#$%&'()*+,-./0123456789:;<portablecabal-devel@haskell.org y=#Parser with simple error reporting >?@ABCD=>?@ABCD=>?@ABCD=>?>?@ABCDportablecabal-devel@haskell.orgEz{|}FGHIJKLMNO EFGHIJKLMNO EFGHIJKLMNO EFGHIJKLMNOportablecabal-devel@haskell.orgPQRSTPQRSTPQRSTPQRQRST portablecabal-devel@haskell.org UA valid Haskell module name. ~VW Construct a U from a valid module name +. MThis is just a convenience function intended for valid module strings. It is N an error if it is used with a string that is not a valid module name. If you ! are parsing user input then use Distribution.Text.simpleParse instead. XThe module name Main. YEThe individual components of a hierarchical module name. For example 3 components (fromString "A.B.C") = ["A", "B", "C"] ZFConvert a module name to a file path, but without any file extension.  For example: + toFilePath (fromString "A.B.C") = "A/B/C" UVWXYZUWYZXVUVWXYZ portablecabal-devel@haskell.org/[\]^_`abcdefghijklmnopqrstuvwxyz3How strict to be when classifying strings into the n and ] 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 @ 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. {|}#[\]^_`abcdefghijklmnopqrstuvwxyz{|}#nzyxwvutsrqpo{]mlkjihgfedcba`_^|[\}#[\\]mlkjihgfedcba`_^^_`abcdefghijklmn zyxwvutsrqpoopqrstuvwxyz{|} portablelibraries@haskell.orgZ~&Enable non-decreasing indentation for 'do' blocks. Enable deriving for the Data.Foldable.Foldable class. Enable deriving for the Data.Traversable.Traversable class. Enable deriving for the Data.Functor.Functor class. Local (let and where) bindings are monomorphic. 0Allow contexts to be put on datatypes, e.g. the Eq a in  /data Eq a => Set a = NilSet | ConsSet a (Set a). Make forall3 a keyword in types, which can be used to give the  generalisation explicitly. ?Makes much of the Haskell sugar be desugared into calls to the 3 function with a particular name that is in scope. Improve the layout rule when if expressions are used in a do  block. !Support for patterns of the form n + k, where k is an  integer literal. BAllows GHC primops, written in C--, to be imported into a Haskell  file. (Enables the use of tuple sections, e.g. (, True) desugars into  x -> (x, True). ?Allow regular pattern matching over lists, as discussed in the  paper "Regular Expression Patterns"" by Niklas Broberg, Andreas Farre # and Josef Svenningsson, from ICFP '04. BAllow concrete XML syntax to be used in expressions and patterns, 5 as per the Haskell Server Pages extension language:   &http://www.haskell.org/haskellwiki/HSP. The ideas behind it are  discussed in the paper ",Haskell Server Pages through Dynamic Loading" * by Niklas Broberg, from Haskell Workshop '05.  GHC  7.3.6. Enable view patterns, which match a value by 1 applying a function and matching on the result.  GHC  7.3.10) Enable generalized list comprehensions, 5 supporting operations such as sorting and grouping.  GHC  7.9.52 Enable quasi-quotation, a mechanism for defining 3 new concrete syntax for expressions and patterns.  GHC  7.3.12+ Relax the interpretation of left operator , sections to allow unary postfix operators.  GHC  7.3.3' Change the syntax for qualified infix  operators.  GHC  7.8.6/ Deprecated in GHC 6.12 and will be removed in 7 GHC 7. Allow a type variable to be instantiated at a  polymorphic type.  GHC  7.3.18. Allow imports to be qualified by the package 7 name the module is intended to be imported from, e.g. ! import "network" Network.Socket  GHC  7.6.1.3 Allow a class method's type to place 2 additional constraints on a class type variable.  GHC  7.5.3 Enable deriving for classes  Data.Typeable.Typeable and Data.Generics.Data.  GHC  7.2.2 Enable unboxed tuples.  GHC  2.4.5, Allow default instantiation of polymorphic  types in more situations.  GHC  7.8.8. Relax the requirements on mutually-recursive  polymorphic functions.  GHC  7.17.2$ Make pattern bindings monomorphic. ?Enable GADT syntax for declaring ordinary algebraic datatypes.  GHC  7.4.6- Enable generalized algebraic data types, in ? which type variables may be instantiated on a per-constructor  basis. Implies GADTSyntax.  GHC  7.6.4/ Enable overloading of string literals using a ) type class, much like integer literals.  GHC  7.3.14/ Allow a record field name to be disambiguated  by the type of the record it's in. Deprecated, use  instead.  GHC  7.3.162 Enable syntax for implicitly binding local names A corresponding to the field names of a record. A wildcard binds  all unmentioned names, unlike .  GHC  7.4.23 Allow the name of a type constructor, type class, + or type variable to be an infix operator.  GHC  7.4.3. Defer validity checking of types until after C expanding type synonyms, relaxing the constraints on how synonyms  may be used.  GHC  8.1.12 Allow the use of unboxed types as foreign types,  e.g. in foreign import and foreign export.  GHC  7.3.1/ Allow certain Unicode characters to stand for C certain ASCII character sequences, e.g. keywords and punctuation.  GHC  7.5.22 Allow a standalone declaration which invokes the  type class deriving mechanism.  GHC  7.7. Allow data types and type synonyms which are 7 indexed by types, i.e. ad-hoc polymorphism for types.  GHC  7.3.2 Allow the character # as a postfix modifier on ? identifiers. Also enables literal syntax for unboxed values.  Hugs  7.31 Enable an alternate syntax for string literals,  with string templating.  Hugs  7.2/ Enable type synonyms which are transparent in B some definitions and opaque elsewhere, as a way of implementing  abstract datatypes.  Hugs  7.1 Enable the "Trex" extensible records system.  GHC  7.5.4 Allow a type declared with newtype to use  deriving9 for any class with an instance for the underlying type.  GHC  7.3.54 Enable a form of guard which matches a pattern and  binds variables.  GHC  7.3.152 Enable syntax for implicitly binding local names C corresponding to the field names of a record. Puns bind specific  names, unlike .  GHC  7.3.11- Enable the implicit importing of the module  Prelude:. When disabled, when desugaring certain built-in syntax E into ordinary identifiers, use whatever is in scope rather than the  Prelude -- version.  GHC  7.165 Enable generic type classes, with default instances 8 defined in terms of the algebraic structure of a type.  GHC  7.10 Enable arrow notation.  GHC  81 Enable the Foreign Function Interface. In GHC, ? implements the standard Haskell 98 Foreign Function Interface . Addendum, plus some GHC-specific extensions.  GHC  7.94 Enable Template Haskell, a system for compile-time  metaprogramming.  GHC  7.6.3.1( Allow type synonyms in instance heads.  GHC  7.112 Enable a form of pattern which forces evaluation 1 before an attempted match, and a form of strict let/where  binding.  GHC  7.8.45 Allow an explicit kind signature giving the kind of * types over which a type variable ranges.  GHC  4.10.30 Run the C preprocessor on Haskell source code.  GHC  7.4.14 Allow data type declarations with no constructors.  GHC  7.6.3.2, Relax some restrictions on the form of the % context of an instance declaration.  GHC  7.8.24 Relax some restrictions on the form of the context  of a type signature.  GHC  7.8.32 Enable implicit function parameters with dynamic  scope. Deprecated, use  instead.  GHC  7.8.74 Cause a type variable in a signature, which has an  explicit forall1 quantifier, to scope over the definition of the ! accompanying value declaration.  GHC  7.4.43 Allow existentially-quantified data constructors.  GHC  7.8.5- Allow data constructors to have polymorphic  arguments. Unlike #, does not allow this for ordinary  functions.  GHC  7.8.51 Allow a universally-quantified type to occur on  the left of a function arrow.  GHC  7.8.5 Like  but does not allow a = higher-rank type to itself appear on the left of a function  arrow.  GHC  7.6.2% Allow a specification attached to a A multi-parameter type class which indicates that some parameters B are entirely determined by others. The implementation will check C that this property holds for the declared instances, and will use ; this property to reduce ambiguity in instance resolution.  GHC  7.17. Enable the dreaded monomorphism restriction.  GHC  7.6.1.1, Allow multiple parameters in a type class.  GHC  7.3.9! Provide syntax for writing list @ comprehensions which iterate over several lists together, like  the  family of functions.  GHC  7.3.8.2/ Deprecated in GHC. Allows recursive bindings  using mdo, a variant of do. DoRec provides a different,  preferred syntax.  GHC  7.3.8 Allows recursive bindings in do blocks,  using the rec keyword.  GHC  7.6.3.4 Implies  . Allow the ? implementation to choose an instance even when it is possible B that further instantiation of types will lead to a more specific  instance being applicable.  GHC  7.6.3.3* Ignore structural rules guaranteeing the ; termination of class instance resolution. Termination is > guaranteed by a fixed-depth recursion stack, and compilation % may fail if this depth is exceeded.  GHC  7.6.3.4$ Allow overlapping class instances, A provided there is a unique most specific instance for each use. 2This represents language extensions beyond a base  definition  (such as 6) that are supported by some implementations, usually  in some special mode. ;Where applicable, references are given to an implementation's  official documentation, e.g. "GHC  7.2.1" for an extension , documented in section 7.2.1 of the GHC User' s Guide. 4An unknown extension, identified by the name of its LANGUAGE  pragma. Disable a known extension Enable a known extension ,This represents a Haskell language dialect.  Language 0s are interpreted relative to one of these base  languages. -An unknown language, identified by its name. AThe Haskell 2010 language as defined by the Haskell 2010 report.   /http://www.haskell.org/onlinereport/haskell2010 =The Haskell 98 language as defined by the Haskell 98 report.   http://haskell.org/onlinereport/ CExtensions that have been deprecated, possibly paired with another  extension that replaces it.  for ~(s 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'-'Z' 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. V~V~V~Jportablecabal-devel@haskell.org<$A complementary representation of a . Instead of a boolean F version predicate it uses an increasing sequence of non-overlapping,  non-empty intervals. KThe key point is that this representation gives a canonical representation  for the semantics of (s. This makes it easier to check things K like whether a version range is empty, covers all versions, or requires a M certain minimum or maximum version. It also makes it easy to check equality 5 or containment. It also makes it easier to identify 'simple' version G predicates for translation into foreign packaging systems that do not , support complex version range expressions. The version range -any*. That is, a version range containing all  versions. ! withinRange v anyVersion = True IThe empty version range, that is a version range containing no versions. JThis can be constructed using any unsatisfiable version range expression,  for example > 1 && < 1. " withinRange v anyVersion = False The version range == v * withinRange v' (thisVersion v) = v' == v The version range   v ||  v - withinRange v' (notThisVersion v) = v' /= v The version range > v * withinRange v' (laterVersion v) = v' > v The version range >= v - withinRange v' (orLaterVersion v) = v' >= v The version range < v , withinRange v' (earlierVersion v) = v' < v The version range <= v / withinRange v' (orEarlierVersion v) = v' <= v The version range  vr1 || vr2 / withinRange v' (unionVersionRanges vr1 vr2) , = withinRange v' vr1 || withinRange v' vr2 The version range vr1 && vr2 3 withinRange v' (intersectVersionRanges vr1 vr2) , = withinRange v' vr1 && withinRange v' vr2 The version range == v.*. For example, for version 1.2, the version range == 1.2.* is the same as  >= 1.2 && < 1.3 ; withinRange v' (laterVersion v) = v' >= v && v' < upper v  where J upper (Version lower t) = Version (init lower ++ [last lower + 1]) t The version range >= v1 && <= v2. LIn practice this is not very useful because we normally use inclusive lower $ bounds and exclusive upper bounds. * withinRange v' (laterVersion v) = v' > v -Fold over the basic syntactic structure of a . LThis provides a syntacic view of the expression defining the version range.  The syntactic sugar ">= v", "<= v" and "== v.*" is presented % in terms of the other basic syntax. For a semantic view use . "-any" version  "== v" "> v" "< v""_ || _" union "_ && _" intersection An extended variant of  that also provides a view of  in which the syntactic sugar ">= v", "<= v" and "== v.*" is presented < explicitly rather than in terms of the other basic syntax. "-any" version  "== v" "> v" "< v" ">= v" "<= v""== v.*" wildcard. The  function is passed the  inclusive lower bound and the  exclusive upper bounds of the  range defined by the wildcard. "_ || _" union "_ && _" intersection "(_)" parentheses /Does this version fall within the given range? (This is the evaluation function for the  type. View a  as a union of intervals. 5This provides a canonical view of the semantics of a  as N opposed to the syntax of the expression used to define it. For the syntactic  view use . GEach interval is non-empty. The sequence is in increasing order and no F intervals overlap or touch. Therefore only the first and last can be < unbounded. The sequence can be empty if the range is empty  (e.g. a range expression like   1 &&  2). DOther checks are trivial to implement using this view. For example:  5 isNoVersion vr | [] <- asVersionIntervals vr = True 6 | otherwise = False  isSpecificVersion vr % | [(LowerBound v InclusiveBound @ ,UpperBound v' InclusiveBound)] <- asVersionIntervals vr  , v == v' = Just v  | otherwise = Nothing  Does this  place any restriction on the  or is it  in fact equivalent to . LNote this is a semantic check, not simply a syntactic check. So for example  the following is True (for all v). G isAnyVersion (EarlierVersion v `UnionVersionRanges` orLaterVersion v) This is the converse of #. It check if the version range is J empty, if there is no possible version that satisfies the version range. For example this is True (for all v): H isNoVersion (EarlierVersion v `IntersectVersionRanges` LaterVersion v) 7Is this version range in fact just a specific version? For example the version range ">= 3 && <= 3" contains only the version  3.  Simplify a * expression. For non-empty version ranges F this produces a canonical form. Empty or inconsistent version ranges 8 are left as-is because that provides more information. !If you need a canonical form use  )fromVersionIntervals . toVersionIntervals 'It satisfies the following properties:  : withinRange v (simplifyVersionRange r) = withinRange v r ( withinRange v r = withinRange v r' 6 ==> simplifyVersionRange r = simplifyVersionRange r'  || isNoVersion r  || isNoVersion r' 'Inspect the list of version intervals. Directly construct a  from a list of intervals. JEach interval must be non-empty. The sequence must be in increasing order K and no invervals may overlap or touch. If any of these conditions are not  satisfied the function returns Nothing. 7Check an upper bound does not intersect a lower bound: --| or ---) or ---] or ---) but not ---] E |--- (--- (--- [--- [--- 6Test if a version falls within the version intervals. JIt exists mostly for completeness and testing. It satisfies the following  properties: > withinIntervals v (toVersionIntervals vr) = withinRange v vr B withinIntervals v ivs = withinRange v (fromVersionIntervals ivs)  Convert a % to a sequence of version intervals.  Convert a  value back into a  expression % representing the version intervals. 22. portablecabal-devel@haskell.org @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  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. Not a recognised license. ; Allows us to deal with future extensions more gracefully. Some other license. DNo rights are granted to others. Undistributable. Most restrictive. ?Holder makes no claim to ownership, least restrictive license. 9The MIT license, similar to the BSD3. Very free license. A4-clause BSD license, older, with advertising clause. You almost 1 certainly want to use the BSD3 license instead.  G3-clause BSD license, newer, no advertising clause. Very free license.  =Lesser GPL, Less restrictive than GPL, useful for libraries.  <GNU Public License. Source code must accompany alterations.                   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 have 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. :Not all kinds of packages can be uniquely identified by a  9. In particular, installed packages cannot, there may be 6 many installed instances of the same source package. 1Describes a dependency on a source package (API) OAn InstalledPackageId uniquely identifies an instance of an installed package. / There can be at most one package with a given  1 in a package database, or overlay of databases. #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.  Simplify the  expression in a .  See .        portablecabal-devel@haskell.orgD!"dir prefix and extension, like "foo/bar/*.baz" corresponds to   FileGlob "foo/bar" ".baz" #&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 G verbosity level. )Useful status messages. We display these at the G 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 H ,(Detailed internal debugging information 6We display these messages when the verbosity level is I -GPerform an IO action, catching any IO exceptions and printing an error  if one occurs. /a description of the action we were attempting the action itself .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. 0123%Run a command and return its output. 9The output is assumed to be text in the locale encoding. 4HRun a command and return its output, errors and exit status. Optionally F also supply some input. Also provides control over whether the binary/text  mode of the input and output. input text and binary mode output in binary mode output, errors, exit 5 Look for a program on the path. 6%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.  version args function to select version  number from program output  location 7/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 8KFind a file by looking in a search path. The file path must match exactly. search locations  File Name 9GFind a file by looking in a search path with one of a list of possible J file extensions. The file base name should be given and it will be tried A with each of the extensions in each element of the search path. :Like 9. but returns which element of the search path K the file was found in, and the file path relative to that base directory. ;<AFinds the files corresponding to a list of Haskell module names. As =! but for a list of module names. #build prefix (location of objects) search suffixes modules =6Find the file corresponding to a Haskell module name. This is similar to : but specialised to a module N name. The function fails if the file corresponding to the module is missing. #build prefix (location of objects) search suffixes module >:List all the files in a directory and all subdirectories. GThe order places files in sub-directories after all the files in their L parent directories. The list is generated lazily so is not well defined if A the source directory structure changes before the list is used. ?@ABSame as createDirectoryIfMissing& but logs at higher verbosity levels. Create its parents too? CKCopies a file without copying file permissions. The target file is created A with default permissions. Any existing target file is replaced. 4At higher verbosity levels it logs an info message. DGInstall an ordinary file. This is like a file copy but the permissions < are set appropriately for an installed file. On Unix it is " -rw-r--r--" L while on Windows it uses the default permissions for the target directory. EIInstall an executable file. This is like a file copy but the permissions < are set appropriately for an installed file. On Unix it is " -rwxr-xr-x" L while on Windows it uses the default permissions for the target directory. FHCopies 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. G This is like F but uses D. HAThis installs all the files in a directory to a target location, K preserving the directory layout. All the files are assumed to be ordinary  rather than executable files. IJK#Use a temporary filename that doesn't already exist. Temp dir to create the file in File name template. See i. L&Create and use a temporary directory. ICreates a new temporary directory inside the given directory, making use H of the template. The temp directory is deleted after use. For example:  @ withTempDirectory verbosity "src" "sdist." $ \tmpDir -> do ... The tmpDir9 will be a new subdirectory of the given directory, e.g.  src/ sdist.342. M@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. NWrites a file atomically. HThe file is either written sucessfully or an IO exception is raised and & the original file is left unchanged. 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. OKWrite 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. P5The 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.) QPackage description file (pkgname.cabal) RCFind a package description file in the given directory. Looks for  .cabal files. Where to look  pkgname.cabal S-Optional auxiliary package information file (pkgname .buildinfo) T;Find auxiliary package information in the given directory.  Looks for  .buildinfo files. Directory to search dir/pkgname .buildinfo , if present UVEIgnore a Unicode byte order mark (BOM) at the beginning of the input W3Reads a UTF8 encoded text file as a Unicode String Reads lazily using ordinary . X3Reads a UTF8 encoded text file as a Unicode String Same behaviour as M. Y5Writes a Unicode String as a UTF8 encoded text file. Uses N#, so provides the same guarantees. Z4Fix different systems silly line ending conventions [\]^_A!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_A$&%'()*+,-12340756IBCJFDEGHP8;9:=<>@A?!#"KLQRSTMNOUVWXYZ[\]^_./?!#""#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_portablecabal-devel@haskell.org`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. a;The location of the program, as located by searching PATH. b(The user gave the path to this program,  eg. --ghc-path=/usr/bin/ghc-6.6 cdefJust the name again g-The version of this program, if it is known. h,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. i-Override command-line args for this program. D These flags will appear last on the command line, so they override  all earlier flags. jLocation of the program. eg. /usr/bin/ghc-6.4 kl.Represents a program which can be configured. mn(The simple name of the program, eg. ghc o*A function to search for the program if it's location was not 4 specified by the user. Usually this will just be a pBTry 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. q<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. r'The full path of a configured program. sMake 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 ... } tMake a simple internal, program; that is, one that was built as an G executable already and is expected to be found in the build directory `abcdefghijklmnopqrstlmnopqtsdefghijrk`bacc`baccabcdefghijefghijklmnopqmnopqrstportablecabal-devel@haskell.orguvwx8Represents a specific invocation of a specific program. LThis is used as an intermediate type between deciding how to call a program G and actually doing it. This provides the opportunity to the caller to L adjust how the program will be called. These invocations can either be run 1 directly or turned into shell or batch scripts. yz{|}~/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. IIt takes four template invocations corresponding to the simple, initial, J middle and last invocations. If the number of args given is small enough K that we can get away with just a single invocation then the simple one is  used:   $ simple args KIf the number of args given means that we need to use multiple invocations K then the templates for the initial, middle and last invocations are used:  $ initial args_0  $ middle args_1  $ middle args_2  ...  $ final args_n uvwxyz{|}~xyz{|}~uwvuwvvwxyz{|}~yz{|}~portablecabal-devel@haskell.orgCall ar; to create a library archive from a bunch of object files. portablecabal-devel@haskell.orgCall ld -r+ to link a bunch of object files together. portablecabal-devel@haskell.orgJGenerate a system script, either POSIX shell script or Windows batch file & as appropriate for the given system. 6Generate a POSIX shell script that invokes a program. 6Generate a Windows batch file that invokes a program. portablecabal-devel@haskell.orgThe default list of programs. 8 These programs are typically used internally to Cabal. portablecabal-devel@haskell.orgDThe 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  mlD but also any user-provided arguments and location for the program. The Read/5Show instance does not preserve all the unconfigured Programs  because ml is not in Read/*Show because it contains functions. So to  fully restore a deserialised  use this function to add  back all the known mls. G It does not add the default programs, but you probably want them, use  * 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.  Program name #user-specified path to the program 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..  Program name user-specified args Like * but for a list of progs and their paths. Like ) but for a list of progs and their args. GGet 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  . $Configure a bunch of programs using  . Just a . 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. IIt raises an exception if the program could not be configured, otherwise $ it returns the configured program. <Check that a program is configured and available to be run. JAdditionally check that the version of the program number is suitable and * return it. For example you could require  AnyVersion or  orLaterVersion ( [1,0] []) MIt raises an exception if the program could not be configured or the version L is unsuitable, otherwise it returns the configured program and its version  number. portablecabal-devel@haskell.org #Runs the given configured program.  Verbosity The program to run Any extra arguments to add 7Runs the given configured program and gets the output.  Verbosity The program to run Any extra arguments to add @Looks up the given program in the program database and runs it.  verbosity The program to run look up the program here Any extra arguments to add @Looks up the given program in the program database and runs it.  verbosity The program to run look up the program here Any extra arguments to add ]56`abcdefghijklmnopqrsxyz{|}~^lmnopqs56defghijrk`baccxyz{|}~ portablecabal-devel@haskell.orgLike + 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 . 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. IThe 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  and the user 0 will have to specify which compiler they want.  >portablecabal-devel@haskell.orgb6We 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. @Parse the stream of tokens into a tree of them, based on indent / layout @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. indent level of the parent/previous line (accumulating param, trees in this level remaining tokens 2collected trees on this level and trailing tokens IParse the stream of tokens into a tree of them, based on explicit braces 5 This parse state expects to find a closing bracket.  line of the '{', used for error messages (accumulating param, trees in this level remaining tokens 2collected trees on this level and trailing tokens *Convert the parse tree into the Field AST 3 Also check for dodgy uses of tabs in indentation.  Convert ifthenelse s to s parse a module name (The parser for the stuff between commas (The parser for the stuff between commas (The parser for the stuff between commas (The parser for the stuff between commas  GPretty-print free-format text, ensuring that it is vertically aligned, ? and with blank lines replaced by dots for correct re-parsing.   6 breaks a string up into a list of strings at newline = characters. The resulting strings do not contain newlines. H H portablelibraries@haskell.org*        0     0     '       portablecabal-devel@haskell.org>The collection of information about packages from one or more  PackageDBs. -Packages are uniquely identified in by their  , they can G also be effeciently looked up by package name or by name and version. +Build an index out of a bunch of packages. If there are duplicates by  then later ones mask earlier  ones. Merge two indexes. MPackages from the second mask packages from the first if they have the exact  same . "For packages with the same source , packages from the second are  " preferred"? over those from the first. Being preferred means they are top & result when we do a lookup by source . This is the mechanism we 3 use to prefer user packages over global packages. )Inserts a single package into the index. 8This is equivalent to (but slightly quicker than) using - or   with a singleton index. 3Removes a single installed package from the index. &Removes all packages with this source  from the index. ERemoves all packages with this (case-sensitive) name 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 source package id (name & version). .Since multiple package DBs mask each other by , ' then we get back at most one package. )Does a lookup by source package id (name & version). >There can be multiple installed packages with the same source   but different  . They are returned in order of , preference, with the most preferred first. &Does a lookup by source package name. >Does a lookup by source 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. "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. #IAll packages that have immediate dependencies that are not in the index. ;Returns such packages along with the dependencies that they' re missing. $BTries to take the transitive closure of the package dependencies. IIf the transitive 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 transitive closure of the packages reverse dependencies.  The given s must be in the index. &'(,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 #. )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. * !"#$%&'()* !#$%&')"(* !"#$%&'()*?portablecabal-devel@haskell.org/CThis is the InstalledPackageInfo type used by ghc-6.4.2 and later. It's here purely for the * 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  !"#$%&'()*+,-./0123456789:;<=>?@<>?@<>?@@portablecabal-devel@haskell.orgAAThis is the InstalledPackageInfo type used by ghc-6.4 and 6.4.1. It's here purely for the * 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 BCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_A_A_portablecabal-devel@haskell.orgB+`,-./0a)Common flags that apply to every command bc1234!Long command line option strings 5"Short command line option strings 6aAn OptionField takes one or more OptDescrs, describing the command line interface for the field. 789:;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. <=>?@ABCDEFDThe name of the command as it would be entered on the command line.  For example "build". GCA short, one line description of the command to use in help texts. H)The useage line summary for this command I<Additional explanation of the command to use in help texts. JInitial / empty flags K'All the Option fields for this command L+Create an option taking a single OptDescr. P No explicit Name is given for the Option, the name is the first LFlag given. M+Create an option taking several OptDescrs. ] You will have to give the flags and description individually to the OptDescr constructor. DMkOptDescr constructors partially applied to flags and description. N/Create a string-valued command line interface. ODCreate a string-valued command line interface with a default value. P(String -> a) variant of reqArg Q(String -> a) variant of optArg RSTUcreate a Choice option V3create 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. deWuto view as a FieldDescr, we sort the list of interfaces (Req > Bool > Choice > Opt) and consider only the first one. fgXhiY;Show flags in the standard long option command line format jkEThe help text for this command with descriptions of all the options. ZMake a Command from standard GetOpt options. name short description long description initial/ empty flags options lm[(Parse a bunch of command line arguments 'Is the command a global or subcommand? \]^EUtility function, many commands do not accept additional flags. This K action fails with a helpful error message if the user supplies any extra. 4+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^4DEFGHIJKY,0/.-[ACBZ+\^];<=>@LMXW6:987?54321NPOQRSTUV4+,0/.--./0123456:987789:;<=><=>?@ACBBCDEFGHIJKEFGHIJKLMNOPQRSTUVWXYZ[\]^portablecabal-devel@haskell.org_`abcd@A boolean expression parameterized over the variable type used. efghijA ConfVar$ represents the variable type used. klmnoA o" is a total or partial mapping of qps to  n< 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)] pA qp2 is the name of a user-defined configuration flag qrCA 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. stuvwxyz{|}~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 ,language used when not explicitly specified (other languages used within the package (language extensions used by all modules 2other language extensions used within the package *the old extensions field, treated same as  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. 8Dependencies specific to a library or executable target The " test-type"! field in the test suite stanza. Some unknown test type e.g. " type: foo" "type: detailed-x.y" "type: exitcode-stdio-x.y" KThe test suite interfaces that are currently defined. Each test suite must & specify which interface it supports. JMore interfaces may be defined in future, either new revisions or totally  new interfaces. FA test suite that does not conform to one of the above interfaces for , the given reason (e.g. unknown test type). Test interface " detailed-0.9"%. The test-suite takes the form of a 5 library containing a designated module that exports "tests :: [Test]". Test interface "exitcode-stdio-1.0" . The test-suite takes the form I of an executable. It returns a zero exit code for success, non-zero for D failure. The stdout and stderr channels may be logged. It takes no / command line parameters and nothing on stdin. A " test-suite" stanza in a cabal file. %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. BThe version of the Cabal spec that this package description uses. C For historical reasons this is specified with a version range but  only ranges of the form >= v& make sense. We are in the process of A transitioning to specifying just a single version, not a range. FThe version of the Cabal spec that this package should be interpreted  against. LHistorically we used a version range but we are switching to using a single K version. Currently we accept either. This function converts into a single 8 version by ignoring upper bounds in the version range. JThe range of versions of the Cabal tools that this package is intended to  work with. MThis function is deprecated and should not be used for new purposes, only to ; support old packages that rely on the old interpretation. &does this package have any libraries? op version of  AIf the package description has a library section, call the given 4 function with the library build info as argument. IGet all the module names from the library (exposed and internal modules) (does this package have any executables? %Perform the action on each buildable  in the package  description. %Get all the module names from an exe (Does this package have any test suites? 0Get all the enabled test suites from a package. $Perform an action on each buildable  in a package. ,Get all the module names from a test suite. The ( for the library (if there is one and it's buildable), and P all buildable executables and test suites. Useful for gathering dependencies. The s used by this component The ,s that are used somewhere by this component The  Extensions0 that are used by all modules in this component 2Select options for a particular Haskell compiler. qrst_`abcdefghijklmnopqrstuvwxyz{|}~xyz{|}~rstuvwpqo_`abcjnmlkdihgfe_`abc`abcdihgfeefghijnmlkklmnopqqrstuvwstuvwxyz{|}~yz{|}~ portablecabal-devel@haskell.org'uvwxyz1A set of targets with their package dependencies {|JA map of dependencies. Newtyped since the default monoid instance is not * appropriate. The monoid instance uses . }~)Result of dependency test. Isomorphic to Maybe d but renamed for  clarity. 6Simplify the condition and return its free variables. (partial) variable assignment ISimplify 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.     JTry 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 C returned. [TODO: Could also be specified with a function argument.] MTODO: 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. 4Domain for each flag name, will be tested in order. .OS as returned by Distribution.System.buildOS 2Arch as returned by Distribution.System.buildArch Compiler flavour + version Additional constraints Dependency test function. ;Either the missing dependencies (error case), or a pair of C (set of build targets with dependencies, chosen flag assignments) BFlatten 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.  DCombine the target-specific dependencies in a TargetSet to give the * dependencies for the package as a whole.  Input map Extra constraints ECollect up the targets in a TargetSet of tagged targets, storing the  dependencies as we go. ?Create a package description with all configurations resolved. This function takes a yx 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. &Explicitly specified flag assignments EIs a given depenency satisfiable from the set of available packages? # If this is unknown then use True. The m] and nn Compiler + Version Additional constraints 4Either missing dependencies or the resolved package 5 description along with the flag assignments 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 ...). KTODO: 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.org8BAn intermediate type just used for parsing the test-suite stanza. 2 After validation it is converted into the proper  type.  Store any fields beginning with x- in the customFields field of D a PackageDescription. All other fields will generate a warning. =Given a parser and a filename, return the parse of the file, $ after checking if the file exists. Parse the given package file. Parses the given file into a yx. IIn Cabal 1.2 the syntax for package descriptions was changed to a format < with sections and possibly indented property descriptions. <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. &descriptions of fields we know how to  parse possibly do something with  unrecognized fields  accumulator fields to be parsed list of parseable fields possibly do something with  unrecognized fields  accumulated result and warnings the field to be parsed ,Recompile with false for regression testing 8Writes a .cabal file from a generic package description  1Writes a generic package description to a string    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 yx and optionally a particular , configuration of that package. If you pass  then we just check , a version of the generic description using . ,-Check that this package description is sane. 3Check that the package declares the version in the " cabal-version"  field correctly. A variation on the normal Text instance, shows any ()'s in the original 3 textual syntax. We need to show these otherwise it's confusing to users when = we complain of their presense but do not pretty print them! BCheck the build-depends fields for any weirdness or bad practise. -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.org01?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. 2345AWe typically get packages from several databases, and stack them J together. This type lets us be explicit about that stacking. For example  typical stacks include:   [GlobalPackageDB] " [GlobalPackageDB, UserPackageDB] = [GlobalPackageDB, SpecificPackageDB "package.conf.inplace"] Note that the 9& is invariably at the bottom since it F contains the rts, base and other special compiler-specific packages. JWe are not restricted to using just the above combinations. In particular I we can use several custom package dbs and the user package db together. ?When it comes to writing, the top most (last) package is used. 6BSome 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. 789:;<=>?@ABKReturn the package that we should register into. This is the package db at  the top of the stack. CDEFCFor the given compiler, return the extensions it does not support. GGFor the given compiler, return the flags for the supported extensions. (0123456789:;<=>?@ABCDEFG:;<=>?@A69875B1432C0EDGF0143223456987789:;<=>;<=>?@ABCDEFG portablecabal-devel@haskell.orgHCall hc-pkg to register a package. E hc-pkg register {filename | -} [--user | --global | --package-conf] ICall hc-pkg to re-register a package. E hc-pkg register {filename | -} [--user | --global | --package-conf] JCall hc-pkg to unregister a package @ hc-pkg unregister [pkgid] [--user | --global | --package-conf] KCall hc-pkg to expose a package. < hc-pkg expose [pkgid] [--user | --global | --package-conf] LCall hc-pkg to expose a package. < hc-pkg expose [pkgid] [--user | --global | --package-conf] MCall hc-pkg$ to get all the installed packages. NOPQRS HIJKLMNOPQRS HIJKLMNOPQRS HIJKLMNOPQRS!portablecabal-devel@haskell.orgTFConditionally enable Haskell Program Coverage by adding the necessary & GHC options to a PackageDescription. ITODO: do this differently in the build stage by constructing local build 9 info, not by modifying the original PackageDescription. Enable coverage? "dist/" prefix U"dist/" prefix Component subdirectory name Directory containing component's HPC .mix files V"dist/" prefix  Test suite Directory containing test suite' s .tix files W-Path to the .tix file containing a test suite's sum statistics. "dist/" prefix  Test suite X4Returns a list of all the .tix files in a test suite' s .tix file H directory. Returned paths are the complete relative path to each file. "dist/" prefix  Test suite 'All .tix files belonging to test suite Y+Generate the HTML markup for a test suite. "dist/" prefix  Library name TUVWXYUTVWYXTUVWXY"portablecabal-devel@haskell.org<Z[+The result of the test suite being run, eg pass, fail, or error. \%The name of the test suite being run ],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 aThe $pkgid package Id path variable, eg foo-1.0 bThe $version package version path variable cThe $pkg package name path variable dThe $htmldir path variable eThe $docdir path variable fThe  $datasubdir path variable gThe $datadir path variable hThe  $libsubdir path variable iThe $libdir path variable jThe $bindir path variable kThe $prefix path variable l?An abstract path, posibly containing variables that need to be  substituted for to get a real . mThe location prefix for the copy command. nop)The installation directories in terms of ls 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. q: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. rstuvwxyz{|}~6Substitute 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 s with the k and get resulting  ls that still have the k 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  to a l 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 4Z[\]^_`abcdefghijklmnopqrstuvwxyz{|}~4qrstuvwxyz{|}~pmonlZkjihgfedcba`_^]\[4Zkjihgfedcba`_^]\[[\]^_`abcdefghijklmonnopqrstuvwxyz{|}~rstuvwxyz{|}~#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 dynamic linking of the executables. %Enable profiling in the executables. Extra arguments to  configure Enable optimization. Installed executable prefix. Installed executable suffix. Installation paths #path to search for extra libraries  path to search for header files dist prefix verbosity level  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 Enable test suite compilation #Enable test suite program coverage ;Flags that apply at the top level, not to any sub-command. 2All flags are monoids, they come in two flavours:   list flags eg  # --ghc-option=foo --ghc-option=bar gives us all the values [foo, bar]   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  ( and later flags override earlier ones.       !"#$%&'()*+,Arguments to pass to a  configure script, e.g. generated by  autoconf. -.<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"] mno      !"#$%&'()*+,-.     #!" &$%mon,-.'()*+        !"#$%&'()*+,-.$portablecabal-devel@haskell.org /01     %     /01   /01/01%portablecabal-devel@haskell.org5234HResolved internal and external package dependencies for this component.  The 4 specifies a set of build dependencies that must be K satisfied in terms of version ranges. This field fixes those dependencies G to the specific versions available on this machine for this compiler. 56789:;<=0Data cached after configuration step. See also  . >?*Options passed to the configuration step. ; Needed to re-run configuration when .cabal is out of date @;Extra args on the command line for the configuration step. ; Needed to re-run configuration when .cabal is out of date A6The installation directories for the various differnt  kinds of files 2TODO: inplaceDirTemplates :: InstallDirs FilePath BThe compiler we're building with CWhere to build the package. TODO: eliminate hugs's scratchDir, use builddir D+Where to put the result of the Hugs build. EFG9All the components to build, ordered by topological sort ( over the intrapackage dependency graph HI3All the info about the installed packages that the 6 current package depends on (directly or indirectly). J6the filename containing the .cabal file, if available K8The resolved package description, that does not contain  any conditionals. L#Location and args for all programs M$What package database to use, global/user NWhether to build normal libs. O-Whether to build profiling versions of libs. P*Whether to build shared versions of libs. Q(Whether to link executables dynamically R,Whether to build executables for profiling. S3Whether to build with optimization (if available). T2Whether to build libs suitable for use with GHCi. U'Use -split-objs with GHC, if available V,Whether to strip executables during install W0Prefix to be prepended to installed executables X/Suffix to be appended to installed executables YKExternal package dependencies for the package as a whole, the union of the  individual targetPackageDeps. ZKThe installed package Id we use for local packages registered in the local M package db. This is what is used for intra-package deps between components. [\HObtains all components (libs, exes, or test suites), transformed by the L given function. Useful for gathering dependencies with component context. ]AIf the package description has a library section, call the given I function with the library build info as argument. Extended version of  + that also gives corresponding build info. ^%Perform the action on each buildable  in the package # description. Extended version of  that also gives corresponding  build info. _`%Perform the action on each buildable  or  (Component) H in the PackageDescription, subject to the build order specified by the  G field of the given >= aSee  bSee  ccZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~23456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abc2=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ9<;:[\5876234`]^_abc22343458766789<;::;<=>?@ABCDEFGHIJKLMNOPQRSTUVWX>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abc&portablecabal-devel@haskell.org defg5The directory in which we put auto-generated modules hi@The name of the auto-generated module associated with a package jklmnExtension for executable files  (typically "" on Unix and "exe" on Windows or OS/2) o=Extension for object files. For GHC and NHC the extension is "o".  Hugs uses either "o" or "obj"# depending on the used C compiler. p7Extension for dynamically linked (or shared) libraries  (typically "so" on Unix and "dll" on Windows) defghijklmnopdefgihjklmnop defghijklmnop'portablecabal-devel@haskell.org q'The flags for the supported extensions rsBuilding a package for JHC. - Currently C source files are not supported. t Building an executable for JHC. - Currently C source files are not supported. uvqrstuvqrstuvqrstuv(portablecabal-devel@haskell.orgw'The flags for the supported extensions x KThis is a backup option for existing versions of nhc98 which do not supply K proper installed package info files for the bundled libs. Instead we look @ for the .cabal file and extract the package version from that.  We don'Et know any other details for such packages, in particular we pretend ! that they have no dependencies. !y?FIX: For now, the target must contain a main module. Not used  ATM. Re-add later. z Building an executable for NHC. "#{Install executables for NHC.  verbosity install location Build location Executable (prefix,suffix) |$Install for nhc98: .hi and .a files  verbosity install location Build location wxyz{|wxyz|{wxyz{|)portablecabal-devel@haskell.org}$%(The flags for the supported extensions. ~&'(KHack to add version numbers to UHC-builtin packages. This should sooner or ! later be fixed on the UHC side. )+Name of the installed package config file. *CCheck if a certain dir contains a valid package. Currently, we are F looking only for the presence of an installed package configuration. B TODO: Actually make use of the information provided in the file. +,5Create a trivial package info from a directory name. -./012}~}~}~*portablecabal-devel@haskell.org+portablecabal-devel@haskell.orgDGenerates the name of the environment variable controlling the path  component of interest. path component; one of "bindir", "libdir",  "datadir" or " libexecdir" environment variable name 345,portablecabal-devel@haskell.org$0Logs test suite results, itemized by test case. ILogs all test results for a package, broken down first by test suite and  then by test case. 6A 2 with package and platform information specified. 7From a &, determine if the test suite passed. From a &, determine if the test suite failed. From a 2, determine if the test suite encountered errors. 8IRun a test executable, logging the output and generating the appropriate  summary messages. flags Cabal was invoked with 1description of package the test suite belongs to $information from the configure step TestSuite being tested +prepare standard input for test executable executable name generator for the TestSuiteLog 0generator for final human-readable log filename  Perform the "./ setup test" action. !information from the .cabal file $information from the configure step flags sent to test 9CPrint a summary to the console after all test suites have been run E indicating the number of successful test suites and cases. Returns : if  all test suites passed and ; otherwise. <%Print a summary of a single test case'$s result to the console, supressing 5 output for certain verbosity or test filter levels. =!Print a summary of the test suite'&s results on the console, suppressing 5 output for certain verbosity or test filter levels. >?@ABJThe filename of the source file for the stub executable associated with a  library  TestSuite. :The name of the stub executable associated with a library  TestSuite. $Write the source file for a library  TestSuite stub executable. library  TestSuite for which a stub  is being created $path to directory where stub source  should be located C3Source code for library test suite stub executable  The test runner used in library  TestSuite stub executables. Runs a list  of TestBs. An executable calling this function is meant to be invoked as % the child of a Cabal process during ./ setup test. A , M provided by Cabal, is read from the standard input; it supplies the name of N the test suite and the location of the machine-readable test suite log file. N Human-readable log information is written to the standard output for capture  by the calling Cabal process. -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  for a given & component (lib, exe, or test suite). DDFind the first extension of the file that exists, and preprocess it  if required. source directories build directory preprocess for sdist module file name  verbosity builtin suffixes possible preprocessors EFGHIJKL?Convenience function; get the suffixes of these preprocessors. HStandard preprocessors: GreenCard, c2hs, hsc2hs, happy, alex and cpphs. .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. 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. !Hook to run before test command. ;Over-ride this hook to get different behavior during test.  Hook to run after test command. Empty  which do nothing. )))&/portablecabal-devel@haskell.org Create a source distribution. information from the tarball Information from configure  verbosity & snapshot build prefix (temp dir) (extra preprocessors (includes suffixes) *Prepare a directory tree of source files.  verbosity info from the cabal file  dist dir source tree to populate (extra preprocessors (includes suffixes) 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 .  verbosity info from the cabal file  dist dir source tree to populate (extra preprocessors (includes suffixes) M verbosity info from the cabal file  source tree  Modifies a  by appending a snapshot number " corresponding to the given date.  Modifies a . 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.  verbosity info from cabal file info from configure source tree to archive name of archive to create N/Move the sources into place based on buildInfo  verbosity info from the cabal file  dist dir  TargetPrefix (extra preprocessors (includes suffixes) Exposed modules OP*The name of the tarball without extension Q0portablecabal-devel@haskell.orgRST'The flags for the supported extensions UVWXYJThis is a backup option for existing versions of Hugs which do not supply K proper installed package info files for the bundled libs. Instead we look J for the Paths_pkgname.hs file and extract the package version from that.  We don'Et know any other details for such packages, in particular we pretend ! that they have no dependencies. ZBuilding a package for Hugs. !Building an executable for Hugs. [output directory &library source dirs, if building exes Modules \]^_`abcdeARead the initial part of a source file, before any Haskell code, G and return the contents of any LANGUAGE, OPTIONS and INCLUDE pragmas. fg$Strip comments from Haskell source. preserve pragmas? input source text 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>.  verbosity Library install location Program install location Executable install location "Program location on target system Build location Executable (prefix,suffix) hi<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. 1portablecabal-devel@haskell.org!jGiven something like usrlocalbin ghc-6.6.1(.exe) we try and find E the corresponding tool; e.g. if the tool is ghc-pkg, we try looking B for a versioned or unversioned ghc-pkg in the same dir, that is: ( /usr/local/bin/ghc-pkg-ghc-6.6.1(.exe) $ /usr/local/bin/ghc-pkg-6.6.1(.exe)  /usr/local/bin/ghc-pkg(.exe) kGiven 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-ghc-6.6.1(.exe) $ /usr/local/bin/ghc-pkg-6.6.1(.exe)  /usr/local/bin/ghc-pkg(.exe) lGiven something like usrlocalbin"ghc-6.6.1(.exe) we try and find a K corresponding hsc2hs, we try looking for both a versioned and unversioned " hsc2hs in the same dir, that is: ' /usr/local/bin/hsc2hs-ghc-6.6.1(.exe) # /usr/local/bin/hsc2hs-6.6.1(.exe)  /usr/local/bin/hsc2hs(.exe) m0Adjust the way we find and configure gcc and ld nopJFor GHC 6.6.x and earlier, the mapping from supported extensions to flags qrst;Get the packages from specific PackageDBs, not cumulative. uBuild a library with GHC. Build an executable with GHC. v Filter the  -threaded$ flag when profiling as it does not  work with ghc-6.8 and older. w<Extracts a String representing a hash of the ABI of a built > library. It can fail if the library has not yet been built. xyz{|Install executables for GHC. Where to copy the files to Build location Executable (prefix,suffix) }7Install for ghc, .hi, .a and, if --with-ghci given, .o install location &install location for dynamic librarys Build location ~On MacOS X we have to call ranlib' to regenerate the archive index after K copying. This is because the silly MacOS X linker checks that the archive = index is not older than the file itself, which means simply  copying/ installing the file breaks it!!    2portablecabal-devel@haskell.org0Adjust the way we find and configure gcc and ld ;Get the packages from specific PackageDBs, not cumulative. Build a library with LHC. Build an executable with LHC.  Filter the  -threaded$ flag when profiling as it does not  work with ghc-6.8 and older. Install executables for GHC. Where to copy the files to Build location Executable (prefix,suffix) 7Install for ghc, .hi, .a and, if --with-ghci given, .o install location &install location for dynamic librarys Build location 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.    3portablecabal-devel@haskell.org Install in the user's database?; verbose  Construct ) for a library in a package, given a set  of installation directories. (Translate relative include dir paths to  absolute paths.  Construct & for a library that is inplace in the  build tree. :This function knows about the layout of inplace packages. top of the build tree location of the dist tree  Construct % for the final install location of a  library package. <This function knows about the layout of installed packages. 4portablecabal-devel@haskell.org5Build the libraries and executables in this package. (Mostly information from the .cabal file Configuration information $Flags that the user passed to build &preprocessors to run before compiling 7Initialize a new package db file for libraries defined  internally to the package. dist prefix (mostly information from the .cabal file Configuration information The verbosity to use !Generate and write out the Paths_ pkg.hs and cabal_macros.h files 5portablecabal-devel@haskell.org,the FilePath of a directory, it's a monoid under ( /) Rrecord that represents the arguments to the haddock executable, a product monoid. @path of the interface file, relative to argOutputDir, required. @package name, required. "(hide modules ?, modules to hide)  ingore export lists in modules? -(template for modules, template for symbols) optinal custom css file. HHtml or Hoogle doc or both? required.  1(interface file, path to the html docs for links) %where to generate the documentation. page';s title, required. @prologue text, required. .additional flags to pass to ghc for haddock-2 Mto find the correct ghc, required by haddock-2. modules to process. Bperforms cpp and unlit preprocessing where needed on the files in 9 | argTargets, which must have an .hs or .lhs extension. template for html location are we using haddock-2.x ? +Call haddock with the specified arguments. ;The directory where we put build results for an executable 6portablecabal-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. HTest for a package dependency and record the version we have installed. Internally defined packages Installed packages JCurrently the user interface specifies the package dbs to use with just a  single valued option, a 6&. However internally we represent the  stack of 66s explictly as a list. This function converts encodes 6 the package db stack implicit in a single packagedb. 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.                  7portablecabal-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. !information from the .cabal file $information from the configure step flags sent to copy or install 'Install the files listed in data-files -Install the files listed in install-includes 8portablecabal-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 :   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. ~      S123456789:;<=>?@ABCDEFG2SABCABDABEABEAFGHIJKLMNOPQRSTUVVWXYZ[=\=]^_`abcdefghijklmnopqrstuvwxyz{|}~                                                                                                                        !"#$%&'()*+,-./0123456789:;<=>? @ A B C D E F G H I J K L M N O O P P Q Q R S T U U V W X Y Z[[\]^_`abcdefghijklmnopqrstuvwxyz{|}~     >>>>>>>>>>>>>>> !"#$%&'()*+,-./01234L56789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmmnopqrstuuvwxyz{n|}~67934S+ !"#$%&'()      !"#$%&'()*+,-./01234456789:;<=>?@ABCDEFGHIJKKLMNOPQRSTUVW 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"{"|"}"~"""""""""""""""""""""""""""""""########################################################################################################################## # # # # ################### #!#"###$#%#&#'#(###)#*#+#,#-#.$/$0$1%2%2%3%4%5%6%7%8%9%:%;%<%<%=%>%?%@%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%[%\%]%^%%%&_&`&a&b&c&d&e&f&g&h&i&j&k'l'm'n'o'p'q(l(m(n(o(q(p)l)m)n)o)p)r*s+s+t,u,u,v,w,x,y,y,R,z,{,|,|,,@,},,~,,,,,,,------------------.........................................////////0l0m0n0o00r1l1m11n1o11111q1p1r2l2m2n2o222q2p2r3X33r3333Z444556666666l6m666678/80888188899999999999AAAN::::::: :k:l: :h: : : :::::::g:::::::::;;;;; A!"<#<$<%<&<'<(<)A*+A*,=-=.=/=0=12345MO678J9:;<=  > ? @ A B C D E F G H I J AKL M N OAPQ RSTUVWXYZ[\]^_ `abcdeA*fghijklmnopAqrstAuv>w>x>y>z>{>|>}>>~>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>&EW?@?B?C?D?F?G?H?I?Q?Q?R?S?A??? ?!?"?#?$?%?&?(?)?*?+?,?.?/?0?1?2?3?4?L?5?6?7?8?9?:?;?????@@@@ @!@"@#@$@%@&@(@)@*@+@,@.@/@0@1@3@4@L@5@6@7@8@9@:@;@@]AuJH     _ !"#$%&'()*!"+,-./012345U6789:;<=>?@ABCDEFGHIJKLMNOPQR S T U V W X Y"Z"["\"A]^"|"_"`"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({(|(}(~((((T(())))})))))))))))+++,,,,,,,,,,,,---------/////0000}0~0000T000000000000000111111111111111111111222222222222222233344n4o55555555555555555555555555555555555555555566666 6 6 6 6 66666666666666778j88k8o88n8p8l8m8q8 8r8s8!8"8#8$8%8&8'8(8)8*+ Cabal-1.12.0Distribution.VersionDistribution.Compat.ReadPDistribution.TestSuite$Distribution.Simple.PreProcess.UnlitDistribution.Simple.UtilsDistribution.ReadEDistribution.VerbosityDistribution.TextDistribution.ModuleNameDistribution.SystemLanguage.Haskell.ExtensionDistribution.LicenseDistribution.Package!Distribution.Simple.Program.TypesDistribution.Simple.Program.RunDistribution.Simple.Program.ArDistribution.Simple.Program.Ld"Distribution.Simple.Program.Script#Distribution.Simple.Program.BuiltinDistribution.Simple.Program.DbDistribution.Simple.ProgramDistribution.Compiler%Distribution.PackageDescription.Parse!Distribution.InstalledPackageInfo Distribution.Simple.PackageIndexDistribution.Simple.CommandDistribution.PackageDescription-Distribution.PackageDescription.Configuration+Distribution.PackageDescription.PrettyPrint%Distribution.PackageDescription.CheckDistribution.Simple.Compiler!Distribution.Simple.Program.HcPkgDistribution.Simple.HpcDistribution.Simple.InstallDirsDistribution.Simple.SetupDistribution.Make"Distribution.Simple.LocalBuildInfoDistribution.Simple.BuildPathsDistribution.Simple.JHCDistribution.Simple.NHCDistribution.Simple.UHC Distribution.Simple.Build.Macros%Distribution.Simple.Build.PathsModuleDistribution.Simple.TestDistribution.Simple.PreProcessDistribution.Simple.UserHooksDistribution.Simple.SrcDistDistribution.Simple.HugsDistribution.Simple.GHCDistribution.Simple.LHCDistribution.Simple.RegisterDistribution.Simple.BuildDistribution.Simple.HaddockDistribution.Simple.ConfigureDistribution.Simple.InstallDistribution.Simple Paths_CabalDistribution.GetOptDistribution.Compat.ExceptionDistribution.Compat.TempFileDistribution.Compat.CopyFileDistribution.ParseUtilsDistribution.Simple.GHC.IPI642Distribution.Simple.GHC.IPI641base Data.Version versionTags versionBranchVersionText.ParserCombinators.ReadPReadSTest PureTestablerunImpureTestablerunMResultErrorFailPass TestOptionsnameoptionsdefaultOptionscheckOptions lookupOptionpureimpureplainunlitsetFileOrdinarysetFileExecutableReadPgetlookpfail+++<++gathersatisfycharstringmunchmunch1choice skipSpacescountbetweenoptionoptionalmanymany1skipMany skipMany1sepBysepBy1endByendBy1chainrchainlchainr1chainl1manyTill readP_to_S readS_to_PReadErunReadE succeedReadE failReadE parseReadE readEOrFail readP_to_E Verbositysilentnormalverbose deafening moreVerbose lessVerboseintToVerbosityflagToVerbosity showForCabal showForGHCTextdispparsedisplay simpleParse ModuleNamesimple fromStringmain components toFilePathPlatformArch OtherArchVaxM68kRs6000HppaAlphaS390IA64SHMipsArmSparcPPC64PPCX86_64I386OSOtherOSHaLVMIRIXHPUXAIXSolarisNetBSDOpenBSDFreeBSDOSXWindowsLinuxbuildOS buildArch buildPlatformKnownExtensionNondecreasingIndentationDeriveFoldableDeriveTraversable DeriveFunctorMonoLocalBindsDatatypeContextsExplicitForAllRebindableSyntaxDoAndIfThenElseNPlusKPatternsGHCForeignImportPrim TupleSectionsRegularPatterns XmlSyntax ViewPatternsTransformListComp QuasiQuotesPostfixOperatorsNewQualifiedOperatorsImpredicativeTypesPackageImportsConstrainedClassMethodsDeriveDataTypeable UnboxedTuplesExtendedDefaultRulesRelaxedPolyRec MonoPatBinds GADTSyntaxGADTsOverloadedStringsDisambiguateRecordFields RecordPunsRecordWildCards TypeOperatorsLiberalTypeSynonymsUnliftedFFITypes UnicodeSyntaxStandaloneDeriving TypeFamilies MagicHash HereDocumentsRestrictedTypeSynonymsExtensibleRecordsGeneralizedNewtypeDeriving PatternGuardsNamedFieldPunsImplicitPreludeGenericsArrowsForeignFunctionInterfaceTemplateHaskellTypeSynonymInstances BangPatternsKindSignaturesCPPEmptyDataDeclsFlexibleInstancesFlexibleContextsImplicitParamsPatternSignaturesScopedTypeVariablesExistentialQuantificationPolymorphicComponents RankNTypes Rank2TypesFunctionalDependenciesMonomorphismRestrictionMultiParamTypeClassesParallelListComp RecursiveDoDoRecIncoherentInstancesUndecidableInstancesOverlappingInstances ExtensionUnknownExtensionDisableExtensionEnableExtensionLanguageUnknownLanguage Haskell2010 Haskell98knownLanguagesknownExtensionsdeprecatedExtensionsBoundInclusiveBoundExclusiveBound UpperBound NoUpperBound LowerBoundVersionIntervalVersionIntervals VersionRangeVersionRangeParensIntersectVersionRangesUnionVersionRangesWildcardVersionEarlierVersion LaterVersion ThisVersion AnyVersion anyVersion noVersion thisVersionnotThisVersion laterVersionorLaterVersionearlierVersionorEarlierVersionunionVersionRangesintersectVersionRanges withinVersionbetweenVersionsInclusivefoldVersionRangefoldVersionRange' withinRangeasVersionIntervals isAnyVersion isNoVersionisSpecificVersionsimplifyVersionRangeversionIntervalsmkVersionIntervalswithinIntervalstoVersionIntervalsfromVersionIntervalsunionVersionIntervalsintersectVersionIntervalsLicenseUnknownLicense OtherLicenseAllRightsReserved PublicDomainMITBSD4BSD3LGPLGPL knownLicensesPackageFixedDepsdependsPackage packageId DependencyInstalledPackageIdPackageIdentifierpkgName pkgVersion PackageId PackageNamethisPackageVersionnotThisPackageVersionsimplifyDependency packageNamepackageVersionFileGlobNoGlob cabalVersiondieWithLocationdie topHandlerwarnnotice setupMessageinfodebug chattyTrywrapTextwrapLine maybeExit rawSystemExitrawSystemExitWithEnvrawSystemStdoutrawSystemStdInOutfindProgramLocationfindProgramVersionxargsfindFilefindFileWithExtensionfindFileWithExtension' findFirstFilefindModuleFilesfindModuleFilegetDirectoryContentsRecursive parseFileGlob matchFileGlobmatchDirFileGlobcreateDirectoryIfMissingVerbosecopyFileVerboseinstallOrdinaryFileinstallExecutableFile copyFilesinstallOrdinaryFilesinstallDirectoryContentssmartCopySourcescopyDirectoryRecursiveVerbose withTempFilewithTempDirectorywithFileContentswriteFileAtomic rewriteFile currentDirdefaultPackageDescfindPackageDescdefaultHookedPackageDescfindHookedPackageDescfromUTF8toUTF8 readUTF8FilewithUTF8FileContents writeUTF8FilenormaliseLineEndingsequating comparing isInfixOf intercalate lowercaseProgramLocation FoundOnSystem UserSpecified locationPathConfiguredProgram programIdprogramVersionprogramDefaultArgsprogramOverrideArgsprogramLocationProgArgProgram programNameprogramFindLocationprogramFindVersionprogramPostConf programPath simplePrograminternalProgram IOEncodingIOEncodingUTF8IOEncodingTextProgramInvocationprogInvokePathprogInvokeArgs progInvokeEnv progInvokeCwdprogInvokeInputprogInvokeInputEncodingprogInvokeOutputEncodingemptyProgramInvocationsimpleProgramInvocationprogramInvocationrunProgramInvocationgetProgramInvocationOutputmultiStageProgramInvocationcreateArLibArchivecombineObjectFilesinvocationAsSystemScriptinvocationAsShellScriptinvocationAsBatchFilebuiltinPrograms ghcProgram ghcPkgProgram lhcProgram lhcPkgProgram nhcProgram hmakeProgram jhcProgram uhcProgram hugsProgramffihugsProgram happyProgram alexProgram gccProgram ranlibProgram arProgram stripProgram hsc2hsProgram c2hsProgram cpphsProgramhscolourProgramhaddockProgramgreencardProgram ldProgram tarProgram cppProgrampkgConfigProgram ProgramDbemptyProgramDbdefaultProgramDbrestoreProgramDbaddKnownProgramaddKnownProgramslookupKnownProgram knownProgramsuserSpecifyPathuserMaybeSpecifyPathuserSpecifyArgsuserSpecifyPathsuserSpecifyArgssuserSpecifiedArgs lookupProgram updateProgramconfigureProgramconfigureAllKnownProgramsreconfigureProgramsrequireProgramrequireProgramVersionProgramConfiguration runProgramgetProgramOutput runDbProgramgetDbProgramOutputrawSystemProgramrawSystemProgramStdoutrawSystemProgramConfrawSystemProgramStdoutConfemptyProgramConfigurationdefaultProgramConfigurationrestoreProgramConfigurationfindProgramOnPath CompilerIdCompilerFlavor OtherCompilerUHCLHCJHCHeliumHBCHugsYHCNHCGHCparseCompilerFlavorCompatbuildCompilerFlavordefaultCompilerFlavor FieldDescr fieldNamefieldGetfieldSet ParseResultParseOk ParseFailedPWarningPError FromString TabsErrorNoParse AmbigousParseLineNoInstalledPackageInfoInstalledPackageInfo_installedPackageIdsourcePackageIdlicense copyright maintainerauthor stabilityhomepagepkgUrlsynopsis descriptioncategoryexposedexposedModules hiddenModulestrusted importDirs libraryDirs hsLibrariesextraLibrariesextraGHCiLibraries includeDirsincludes hugsOptions ccOptions ldOptions frameworkDirs frameworkshaddockInterfaces haddockHTMLsemptyInstalledPackageInfoparseInstalledPackageInfoshowInstalledPackageInfoshowInstalledPackageInfoFieldfieldsInstalledPackageInfo SearchResult Ambiguous UnambiguousNone PackageIndexfromListmergeinsertdeleteInstalledPackageIddeleteSourcePackageIddeletePackageName allPackagesallPackagesByNamelookupInstalledPackageIdlookupSourcePackageIdlookupPackageNamelookupDependency searchByNamesearchByNameSubstringdependencyCyclesbrokenPackagesdependencyClosurereverseDependencyClosuretopologicalOrderreverseTopologicalOrderdependencyGraphdependencyInconsistenciesmoduleNameIndexCommand CommandParseCommandReadyToGo CommandErrors CommandList CommandHelp MkOptDescrArgPlaceHolderOptFlagsLFlagsSFlagsOptDescrBoolOpt ChoiceOptOptArgReqArg OptionField optionName optionDescr DescriptionNameShowOrParseArgs ParseArgsShowArgs CommandUI commandNamecommandSynopsis commandUsagecommandDescriptioncommandDefaultFlagscommandOptions multiOptionreqArgoptArgreqArg'optArg'noArgboolOptboolOpt' choiceOptchoiceOptFromEnumviewAsFieldDescr liftOptioncommandShowOptions makeCommandcommandParseArgscommandAddAction commandsRun noExtraFlagsCondTreeCondNode condTreeDatacondTreeConstraintscondTreeComponents ConditionCAndCOrCNotLitVarConfVarImplFlagFlagAssignmentFlagNameMkFlagflagNameflagDescription flagDefault flagManualGenericPackageDescriptionpackageDescriptiongenPackageFlags condLibrarycondExecutablescondTestSuitesRepoType OtherRepoTypeMonotoneBazaarGnuArch MercurialCVSSVNGitDarcsRepoKindRepoKindUnknownRepoThisRepoHead SourceReporepoKindrepoType repoLocation repoModule repoBranchrepoTag repoSubdirHookedBuildInfo BuildInfo buildable buildTools cppOptionspkgconfigDependscSources hsSourceDirs otherModulesdefaultLanguageotherLanguagesdefaultExtensionsotherExtensions oldExtensions extraLibs extraLibDirsinstallIncludesghcProfOptionsghcSharedOptionscustomFieldsBItargetBuildDependsTestTypeTestTypeUnknown TestTypeLib TestTypeExeTestSuiteInterfaceTestSuiteUnsupportedTestSuiteLibV09TestSuiteExeV10 TestSuitetestName testInterface testBuildInfo testEnabled ExecutableexeName modulePath buildInfoLibrary libExposed libBuildInfo BuildTypeUnknownBuildTypeCustomMake ConfigureSimplePackageDescriptionpackage licenseFile testedWith bugReports sourceReposcustomFieldsPD buildDependsspecVersionRaw buildTypelibrary executables testSuites dataFilesdataDir extraSrcFiles extraTmpFiles specVersiondescCabalVersionemptyPackageDescriptionknownBuildTypes emptyLibraryhasLibswithLib libModulesemptyExecutablehasExeswithExe exeModulesemptyTestSuitehasTests enabledTestswithTest testModulesknownTestTypestestTypeemptyBuildInfo allBuildInfo allLanguages allExtensionsusedExtensionsemptyHookedBuildInfo hcOptionsknownRepoTypesupdatePackageDescriptionparseCondition mapCondTreemapTreeConstrs mapTreeConds mapTreeDatafreeVarsfinalizePackageDescriptionflattenPackageDescriptionpkgDescrFieldDescrslibFieldDescrsexecutableFieldDescrstestSuiteFieldDescrsbinfoFieldDescrsflagFieldDescrssourceRepoFieldDescrsreadHookedBuildInforeadPackageDescriptionparsePackageDescriptionparseHookedBuildInfowritePackageDescriptionshowPackageDescriptionwriteHookedBuildInfoshowHookedBuildInfowriteGenericPackageDescriptionshowGenericPackageDescriptionCheckPackageContentOps doesFileExistdoesDirectoryExist PackageCheckPackageDistInexcusablePackageDistSuspiciousPackageBuildWarningPackageBuildImpossible explanation checkPackagecheckConfiguredPackagecheckPackageFilescheckPackageContentcheckPackageFileNamesOptimisationLevelMaximumOptimisationNormalOptimisationNoOptimisationPackageDBStack PackageDBSpecificPackageDB UserPackageDBGlobalPackageDBCompiler compilerIdcompilerLanguagescompilerExtensionsshowCompilerIdcompilerFlavorcompilerVersionregistrationPackageDBflagToOptimisationLevelunsupportedLanguageslanguageToFlagsunsupportedExtensionsextensionsToFlagsregister reregister unregisterexposehidedumpregisterInvocationreregisterInvocationunregisterInvocationexposeInvocationhideInvocationdumpInvocationenableCoveragehpcDirtixDir tixFilePath findTixFiles doHpcMarkupPathTemplateVariableTestSuiteResultVarTestSuiteNameVarExecutableNameVarArchVarOSVar CompilerVarPkgIdVar PkgVerVar PkgNameVar HtmldirVar DocdirVar DatasubdirVar DatadirVar LibsubdirVar LibdirVar BindirVar PrefixVar PathTemplateCopyDestCopyTo NoCopyDestInstallDirTemplates InstallDirsprefixbindirlibdir libsubdir dynlibdir libexecdirprogdir includedirdatadir datasubdirdocdirmandirhtmldir haddockdircombineInstallDirsdefaultInstallDirssubstituteInstallDirTemplatesabsoluteInstallDirsprefixRelativeInstallDirstoPathTemplatefromPathTemplatesubstPathTemplateinitialPathTemplateEnvpackageTemplateEnvcompilerTemplateEnvplatformTemplateEnvinstallDirsTemplateEnv TestFlags testDistPref testVerbosity testHumanLogtestMachineLogtestShowDetails testKeepTixtestList testOptionsTestShowDetailsAlwaysFailuresNever BuildFlagsbuildProgramPathsbuildProgramArgs buildDistPrefbuildVerbosity CleanFlags cleanSaveConf cleanDistPrefcleanVerbosity HaddockFlagshaddockProgramPathshaddockProgramArgs haddockHoogle haddockHtmlhaddockHtmlLocationhaddockExecutableshaddockInternal haddockCsshaddockHscolourhaddockHscolourCsshaddockDistPrefhaddockVerbosity HscolourFlags hscolourCSShscolourExecutableshscolourDistPrefhscolourVerbosity RegisterFlags regPackageDB regGenScript regGenPkgConf regInPlace regDistPref regVerbosity SDistFlags sDistSnapshotsDistDirectory sDistDistPrefsDistVerbosity InstallFlagsinstallPackageDBinstallDistPrefinstallUseWrapperinstallInPlaceinstallVerbosity CopyFlagscopyDest copyDistPref copyVerbosity ConfigFlagsconfigProgramsconfigProgramPathsconfigProgramArgsconfigHcFlavor configHcPath configHcPkgconfigVanillaLib configProfLibconfigSharedLib configDynExe configProfExeconfigConfigureArgsconfigOptimizationconfigProgPrefixconfigProgSuffixconfigInstallDirsconfigScratchDirconfigExtraLibDirsconfigExtraIncludeDirsconfigDistPrefconfigVerbosityconfigUserInstallconfigPackageDB configGHCiLibconfigSplitObjsconfigStripExesconfigConstraintsconfigConfigurationsFlags configTestsconfigLibCoverage GlobalFlags globalVersionglobalNumericVersionNoFlagdefaultDistPreftoFlagfromFlagfromFlagOrDefault flagToMaybe flagToListdefaultGlobalFlags globalCommandemptyGlobalFlagsdefaultConfigFlagsconfigureCommandconfigureOptionsinstallDirsOptionsemptyConfigFlagsdefaultCopyFlags copyCommandemptyCopyFlagsdefaultInstallFlagsinstallCommandemptyInstallFlagsdefaultSDistFlags sdistCommandemptySDistFlagsdefaultRegisterFlagsregisterCommandunregisterCommandemptyRegisterFlagsemptyHscolourFlagsdefaultHscolourFlagshscolourCommanddefaultHaddockFlagshaddockCommandemptyHaddockFlagsdefaultCleanFlags cleanCommandemptyCleanFlags buildVerbosedefaultBuildFlags buildCommandemptyBuildFlagsdefaultTestFlags testCommandemptyTestFlagstrueArgfalseArgoptionVerbosity configureArgsconfigureCCompilerconfigureLinker defaultMaindefaultMainArgsdefaultMainNoReadComponentLocalBuildInfocomponentPackageDeps ComponentName CTestNameCExeNameCLibName ComponentCTestCExeCLibLocalBuildInfo configFlagsextraConfigArgsinstallDirTemplatescompilerbuildDir scratchDir libraryConfigexecutableConfigscompBuildOrdertestSuiteConfigs installedPkgs pkgDescrFile localPkgDescr withPrograms withPackageDBwithVanillaLib withProfLib withSharedLib withDynExe withProfExewithOptimization withGHCiLib splitObjs stripExes progPrefix progSuffixexternalPackageDepsinplacePackageId foldComponentallComponentsBy withLibLBI withExeLBI withTestLBIwithComponentsLBIsrcPref hscolourPref haddockPrefautogenModulesDir cppHeaderNameautogenModuleName haddockName mkLibName mkProfLibNamemkSharedLibName exeExtension objExtension dllExtension configuregetInstalledPackagesbuildLibbuildExe installLib installExeregisterPackagegenerate pkgPathEnvVarCasecaseName caseOptions caseResult TestSuiteLogcaseslogFile PackageLogplatform suitePassed suiteFailed suiteErrortest stubFilePathstubNamewriteSimpleTestStubrunTestsPPSuffixHandler PreProcessorplatformIndependentrunPreProcessormkSimplePreProcessorrunSimplePreProcessorpreprocessComponent ppGreenCardppUnlitppCppppCpp'ppHsc2hsppC2hsppHappyppAlex ppSuffixesknownSuffixHandlers UserHooksreadDeschookedPreProcessorshookedProgramspreConfconfHookpostConfpreBuild buildHook postBuildpreClean cleanHook postCleanpreCopycopyHookpostCopypreInstinstHookpostInstpreSDist sDistHook postSDistpreRegregHookpostRegpreUnreg unregHook postUnreg preHscolour hscolourHook postHscolour preHaddock haddockHook postHaddockpreTesttestHookpostTestArgsemptyUserHookssdist prepareTreeprepareSnapshotTreesnapshotPackagesnapshotVersiondateToSnapshotNumber createArchiveprintPackageProblemsinstall ghcLibDir libAbiHashghcVerbosityOptions ghcOptionsghcPackageDbOptionsgenerateRegistrationInfogeneralInstalledPackageInfoinplaceInstalledPackageInfoabsoluteInstalledPackageInfobuildinitialBuildStepswriteAutogenFileshaddockhscolourtryGetConfigStateFilegetPersistBuildConfigmaybeGetPersistBuildConfigwritePersistBuildConfigcheckPersistBuildConfigOutdatedlocalBuildInfoFileccLdOptionsBuildInfoconfigCompilerAuxconfigCompilercheckForeignDepsdefaultMainWithHooksdefaultMainWithHooksArgssimpleUserHooksdefaultUserHooksautoconfUserHookscatchIOversion getBinDir getLibDir getDataDir getLibexecDirgetDataFileName ImpureTestPureTestghc-prim GHC.TypesIOGHC.BaseStringData.Typeable.InternalTypeRep Data.Monoidmappend ClassifiedCommentEndCode BeginCodeLineOrdinaryBlank BirdTrackclassify unclassify reclassifyinlines internalErrorOptKindOptErr EndOfOptsNonOptUnreqOptOptArgDescrNoArgOptionArgOrder ReturnInOrderPermute RequireOrder usageInfofmtOptfmtShortfmtLonggetOptgetOpt'getNextlongOptshortOpterrAmbigerrReqerrUnrecerrNoArg onException throwIOIOtryIO catchExitGHC.IO.Exception IOExceptionopenNewBinaryFile pathSeparator std_flags output_flagsrw_flagscreateTempDirectory mkPrivateDir System.IOopenBinaryTempFile openTempFilecopyOrdinaryFilecopyExecutableFile setFileModesetDirOrdinarycopyFileParserRPFinalLookGetfinalErrorMsg DeafeningVerboseNormalSilentvalidModuleCharvalidModuleComponentClassificationStrictnessCompatStrict PermissiveknownOSs osAliases classifyOS knownArches archAliases classifyArchidentGHC.ListzipWithclassifyLanguageclassifyExtensionclassifyKnownExtension Text.ReadreadknownExtensionTablewildcardUpperBoundisWildcardRange minLowerBound isVersion0 invariantcheckInvariant validVersion validIntervalnonEmpty doesNotTouchdoesNotIntersect unionIntervalintersectIntervaldispOptVersionprintRawCommandAndArgsprintRawCommandAndArgsAndEnvcreateDirectoryVerbose buildInfoExt ignoreBOMreadFilemaxCommandLineSizeConfiguredProgsUnconfiguredProgsUnconfiguredProgramunconfiguredProgsconfiguredProgsupdateUnconfiguredProgsupdateConfiguredProgsuserSpecifiedPathconfigurePrograms Control.MonadfoldMknownCompilerFlavorsclassifyCompilerFlavor Data.MaybeNothing SyntaxTreeHasTabsIndentToken CloseBracket OpenBracketSpanFieldIfBlockSectionFUnrecFieldParser UTFWarning showPWarningcatchParseError parseFailrunPrunE utf8WarningslocatedErrorMsg syntaxError tabsErrorwarningfield liftField simpleFieldcommaListFieldspaceListField listField optsField boolFieldppFieldsppField showFieldsshowSingleNamedField parseFieldsparseFieldsFlat accumFields warnUnrec ignoreUnreclineNofName readFieldsreadFieldsFlat trimLines tokeniseLinetokeniseLineFlat trimLeading trimTrailingmkTreelayoutbracesmkFieldifelseparseModuleNameQparseFilePathQparseBuildToolparseBuildToolNameQparseBuildToolNameparsePkgconfigDependencyparsePackageNameQparseVersionRangeQparseOptVersionparseTestedWithQ parseLicenseQparseLanguageQparseExtensionQparseHaskellString parseTokenQ parseTokenQ' parseSepListparseSpaceListparseCommaListparseOptCommaList parseQuoted parseFreeText showFilePath showTokenshowTestedWith showFreeTextlines_basicFieldDescrsinstalledFieldDescrsmkPackageIndexGHC.ReadReadconvertPackageIdmkInstalledPackageIdconvertModuleNameconvertLicense toCurrent CommonFlagListOptionsFlagHelpFlagcommandGetOpts viewAsGetOptgetChoiceByLongFlaggetCurrentChoice liftOptDescrliftSetcommandListOptions commandHelp commonFlagsaddCommonFlagsBool maybeHasLibsMayberepoTypeAliasesclassifyRepoTypePDTaggedPDNullExeLib TargetSet DependencyMapunDependencyMapBTBTBBTN DepTestRslt MissingDepsDepOksimplifyConditionsimplifyWithSysParamsresolveWithFlagstoDepMap fromDepMapsimplifyCondTreeignoreConditionsoverallDependencies constrainByflattenTaggedTargetslibFillInDefaultsexeFillInDefaultstestFillInDefaultsbiFillInDefaultsbugPMStTrunStTTestSuiteStanzatestStanzaTestTypetestStanzaMainIstestStanzaTestModuletestStanzaBuildInfostoreXFieldsPDstoreXFieldsLibstoreXFieldsExeemptyTestStanzastoreXFieldsTestvalidateTestSuitestoreXFieldsBIreadAndParseFilestanzasisStanzaHeadermapSimpleFieldsconstraintFieldNamesparseConstraint libFieldNamesbuildInfoNamesmodifyliftevalStT peekField skipField parseFielddeprecatedFieldsdeprecatedFieldsPkgDescrdeprecatedFieldsBuildInfo deprecFieldppCustomFields ppCustomFieldfindIndentTabs indentWithsimplifiedPrintingppGenericPackageDescriptionppPackageDescription ppSourceRepos ppSourceRepo ppDiffFieldsppGenPackageFlagsppFlag ppLibrary ppExecutables ppTestSuites ppCondition ppConfVar ppFlagName ppCondTreeppDeps emptyLine checkSanity checkLibrarycheckExecutablecheckTestSuite checkFields checkLicensecheckSourceReposcheckGhcOptionscheckCCOptionscheckAlternatives checkPathscheckCabalVersiondisplayRawVersionRangedisplayRawDependencycheckPackageVersionscheckConditionalscheckLicenseExistscheckSetupExistscheckConfigureExistscheckLocalPathsExistcheckMissingVcsInforepoTypeDirnamecheckWindowsPath checkTarPathquotecommaSepdupslanguageToFlagextensionToFlagmungePackagePathssetInstalledPackageIdregisterInvocation'packageDbStackOpts packageDbOpts verbosityOpts legacyVersionPathTemplateEnv PathComponentVariableGHC.IOFilePath appendSubdirscombinePathTemplategetWindowsProgramFilesDirknownTestShowDetailsprogramFlagsDescriptionprogramConfigurationPathsprogramConfigurationOptions reqArgFlagoptionDistPref configureProg splitArgsdefaultMainHelperconfigureAction copyAction installAction haddockAction buildAction cleanAction sdistActionregisterActionunregisterActionmissingLibConfmissingExeConfmissingTestConf jhcLanguagesjhcLanguageExtensionsconstructJHCCmdLine jhcPkgConf nhcLanguagesnhcLanguageExtensionspackageDbPathsgetPackageDbDirsgetInstalledPackagegetFullInstalledPackageInfogetPhonyInstalledPackageInfonhcVerbosityOptionsgetModulePaths uhcLanguagesuhcLanguageExtensionsgetUserPackageDiraddBuiltinVersionsinstalledPkgConfigisPkgDir parsePackagemkInstalledPackageInfoconstructUHCCmdLineuhcPackageDbOptions uhcTargetuhcTargetVariant uhcPackageDiruhcPackageSubDirget_prefix_win32get_prefix_hugsfilename_stufflocalPackageLoggetTestOptionstestControllersummarizePackageTrueFalse summarizeCasesummarizeSuiteFinishsummarizeSuiteStart resultStringtestSuiteLogPath testOptionpackageLogPathsimpleTestStubpreprocessFileppGhcCppppCpphs use_optP_P getCppOptions sysDefines hcDefines versionInt standardPPoverwriteSnapshotPackageDesc prepareDir copyFileTo tarBallNamemapAllBuildInfo getVersion hugsLanguageshugsLanguageExtensionscompileBuildInfosuffixes copyModule compileFilestestFFI compileFFI includeOpts getCFilessymbolswithHaskellFilegetOptionsFromSource takeWhileJust stripCommentshugsInstallSuffixeshugsMainFilenameguessToolFromGhcPathguessGhcPkgFromGhcPathguessHsc2hsFromGhcPathconfigureToolchain getLanguages getExtensionsoldLanguageExtensions ghcLibDir'checkPackageDbStackremoveMingwIncludeDirgetInstalledPackages' substTopDirhackThreadedFlaggetHaskellObjectsconstructGHCCmdLineghcPackageFlagsconstructCcCmdLine ghcCcOptions mkGHCiLibNamestripExeupdateLibArchivewriteHcPkgRegisterScriptregScriptFileNameunregScriptFileNamecreateInternalPackageDBOutputHoogleHtmlTemplate DirectoryDirunDir' HaddockArgsargInterfaceFileargPackageNameargHideModulesargIgnoreExports argLinkSource argCssFile argVerbose argOutput argInterfaces argOutputDirargTitle argPrologue argGhcFlags argGhcLibDir argTargetsunDirprepareSources fromFlagsfromPackageDescription fromLibraryfromExecutable getInterfaces getGhcLibDir runHaddock renderArgsrenderPureArgshaddockPackageFlags hscolour'haddockToHscolourgetLibSourceFilesgetExeSourceFilesgetSourceFiles exeBuildDirFailedDependencyDependencyNoVersionDependencyNotExistsResolvedDependencyInternalDependencyExternalDependencytryGetPersistBuildConfig showHeadercurrentCabalIdcurrentCompilerId parseHeader reportProgram hackageUrlselectDependencyreportSelectedDependenciesreportFailedDependenciesimplicitPackageDbStack!newPackageDepsBehaviourMinVersionnewPackageDepsBehaviourconfigureRequiredProgramsconfigureRequiredProgramconfigurePkgconfigPackagescheckPackageProblemsinstallDataFilesinstallIncludeFilesallSuffixHandlershscolourAction testAction hookedActionsanityCheckHookedBuildInfogetBuildConfigcleanrunConfigureScriptgetHookedBuildInfodefaultTestHookdefaultInstallHookdefaultBuildHookdefaultRegHook