haskell-src-exts-simple 1.18.0.1 → 1.18.0.1.1
raw patch · 4 files changed
+57/−42 lines, 4 filesPVP ok
version bump matches the API change (PVP)
API changes (from Hackage documentation)
Files
- CHANGELOG.md +9/−1
- COMPATIBILITY.md +0/−20
- README.md +45/−3
- haskell-src-exts-simple.cabal +3/−18
CHANGELOG.md view
@@ -1,5 +1,13 @@ # Revision history for haskell-src-exts-simple -## 1.18.0 -- 2016-08-??+## 1.18.0.1.1 -- 2016-08-05++* package description should now look fine on hackage++## 1.18.0.1 -- 2016-08-02++* ghc-7.8 compatibility (see COMPATIBILITY.md for caveats)++## 1.18.0 -- 2016-07-31 * Initial release.
− COMPATIBILITY.md
@@ -1,20 +0,0 @@-# Compatibility notes for haskell-src-exts-simple--## Comparison to haskell-src-exts 1.17 (as of version 1.18):--haskell-src-exts-simple provides a simplified view of the annotated AST in haskell-src-exts, so there are differences to the unannotated AST provided by earlier versions of haskell-src-exts:--* some constructors carried `SrcLoc` information, which is no longer available, notably- - most constructors of the `Decl`, `ModulePragma`, `ImportDecl`, `IPBind`, `ClassDecl`, `InstDecl`, `QualConDecl`, `GadtDecl` datatypes- - the `Lambda`, `ExpTypeSig` and `Proc` constructors of the `Exp` type (and a few XML related ones)- - the `Generator` constructor of `Stmt`- - the `Alt` constructor of `Alt`- - the `PatTypeSig` constructor of `Pat`-* the first three fields (not counting the `SrcLoc`) of the `Module` constructor have been combined into a single field with `ModuleHead` type--(this list is probably incomplete)--## ghc versions--* haskell-src-exts-simple requires ghc-7.8 or later-* Note that with ghc-7.8, the constructors of the `Language.Haskell.Exts.Simple.Syntax.Literal` type are only available for pattern matchin, because construction relies on explicitly bidirectional pattern synonyms for literals. For ghc-7.8 compatibility, you should use the `*L` (`intL` etc.) functions for constructing `Literal` values.
README.md view
@@ -1,10 +1,52 @@ # haskell-src-exts-simple +## Synopsis+ This package provides a shim for haskell-src-exts, exposing the same-AST but without annotations.+AST but without annotations, using ghc's pattern synonyms. This package is useful for synthesizing and manipulating HSE ASTs that don't carry source location information. It may also aid in porting packages from haskell-src-exts 1.17 to 1.18, but it-is not a drop-in replacement for the old annotation-free AST.-See [COMPATIBILITY.md](COMPATIBILITY.md) for details.+is *not* a drop-in replacement for the old annotation-free AST.+See the Compatibility section for details.++## Versioning++To be able to track the haskell-src-exts version numbers conveniently,+the first *three* components of the version will be treated as the+major version, followed by the minor version as usual. This deviates+from the PVP.++## Compatibility++### Comparison to haskell-src-exts 1.17 (as of version 1.18):++haskell-src-exts-simple provides a simplified view of the annotated+AST in haskell-src-exts, so there are differences to the unannotated+AST provided by earlier versions of haskell-src-exts:++* some constructors carried `SrcLoc` information, which is no longer+ available, notably+ - most constructors of the `Decl`, `ModulePragma`, `ImportDecl`,+ `IPBind`, `ClassDecl`, `InstDecl`, `QualConDecl`, `GadtDecl`+ datatypes+ - the `Lambda`, `ExpTypeSig` and `Proc` constructors of the `Exp`+ type (and a few XML related ones)+ - the `Generator` constructor of `Stmt`+ - the `Alt` constructor of `Alt`+ - the `PatTypeSig` constructor of `Pat`+* the second, fourth and fifth fields of the `Module` constructor have+ been combined into a single field of type `ModuleHead`++(this list is probably incomplete)++### ghc compatibility++* haskell-src-exts-simple requires ghc-7.8 or later+* Note that with ghc-7.8, the constructors of the+ `Language.Haskell.Exts.Simple.Syntax.Literal` type are only+ available for pattern matching, because construction relies on+ explicitly bidirectional pattern synonyms for literals. For ghc-7.8+ compatibility, you should use the `*L` (`intL` etc.) functions for+ constructing `Literal` values.
haskell-src-exts-simple.cabal view
@@ -1,25 +1,11 @@ name: haskell-src-exts-simple-version: 1.18.0.1+version: 1.18.0.1.1 synopsis: A simplified view on the haskell-src-exts AST description: This package provides a shim for haskell-src-exts (HSE), exposing the- same AST but without annotations.- .- This package is useful for synthesizing and manipulating HSE ASTs- that don't carry source location information. It may also aid- in porting packages from haskell-src-exts 1.17 to 1.18, but it- is not a drop-in replacement for the old annotation-free AST.- See COMPATIBILITY.md for details.- .- See "Language.Haskell.Exts.Simple" for further information.- .- __Versioning policy__: To be able to track the haskell-src-exts version- numbers conveniently, the first __three__ components of the version- will be treated as the major version, followed by the minor version- as usual.+ same AST but without annotations, using ghc's pattern synonyms. .- __GHC compatibility__: With ghc-7.8, some constructors only work as- patterns. See "Language.Haskell.Exts.Simple.Syntax#t:Literal"+ See README.md for further information and compatibility considerations. license: MIT license-file: LICENSE author: Bertram Felgenhauer@@ -29,7 +15,6 @@ build-type: Simple extra-source-files: README.md,- COMPATIBILITY.md, CHANGELOG.md homepage: https://github.com/int-e/haskell-src-exts-simple cabal-version: >=1.10