Bumping "extralib" library versions

Duncan Coutts duncan.coutts at worc.ox.ac.uk
Mon Oct 22 07:43:05 EDT 2007


All,

There is unfortunately some synchronisation between ghc releases and the
releases of various common libraries, the so-called "extralibs"
collection. So I'd like to look briefly at what the version numbers of
theses packages should be. It is important that we do increase the
version numbers if there are changes since the last releases. In cases
where the package's HEAD repo is maintained somewhere other than
darcs.haskell.org/packages/$pkg that we do not break the version scheme
used by the package maintainer.

The current set of "extralibs" packages is:
ALUT
arrows
cgi
fgl
GLUT
haskell-src
HGL
html
HUnit
mtl
network
ObjectIO
OpenAL
OpenGL
parallel
parsec
QuickCheck
regex-base
regex-compat
regex-posix
stm
time
X11
xhtml

For each one I'd like to identify where the HEAD repo is, what the last
released version was, what the current version number in the darcs
version is, if there are any changes since that release and if so what
the new release number ought to be.

These version number bumps are based on existing versioning practise for
these libraries rather than the proposed package versioning policy.
http://haskell.org/haskellwiki/Package_versioning_policy#Version_numbers
I have also listed for each package what the next version number would
be under the proposed package versioning policy.They are marked as "PVP
next version".

If you think I've got any of these details wrong, please say so.

==========
ALUT

HEAD repo: http://darcs.haskell.org/packages/ALUT
Released version:       2.0.1  (in ghc-6.6.1 extralibs tarball)
Current version:        2.0.1
Changes since release:  minor build system changes
Suggested next version: 2.0.2
PVP next version:       2.0.1.1

==========
arrows

HEAD repo: http://darcs.haskell.org/packages/arrows
Released version:       0.3  (on hackage)
Current version:        0.3
Changes since release:  none
Suggested next version: not needed
PVP next version:       not needed

Notes: The latest version of this package depends on Stream which is not
currently in the extralibs collection. This anomaly will need to be
sorted out.


==========
cgi

HEAD repo: http://darcs.haskell.org/packages/cgi
Released version:       3001.1.5 (on hackage)
Current version:        3001.1.5
Changes since release:  comments and build system changes
Suggested next version: 3001.1.6
PVP next version:       3001.1.5.1

Notes: requires .cabal changes to build with older base versions

==========
fgl

HEAD repo: http://darcs.haskell.org/packages/fgl
Released version: 5.4.1 (in ghc-6.6.1 extralibs tarball)
Current version:  5.4.1
Changes since release: build system changes
Suggested next version: 5.4.2 
PVP next version:       5.4.1.1

Notes: requires .cabal changes to build with older base versions

==========
GLUT

HEAD repo: http://darcs.haskell.org/packages/GLUT
Released version:       2.1.1 (in ghc-6.6.1 extralibs tarball)
Current version:        2.1.1
Changes since release:  build system changes
Suggested next version: 2.1.2
PVP next version:       2.1.1.1

==========
haskell-src

HEAD repo: http://darcs.haskell.org/packages/haskell-src
Released version:       1.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since release:  build system and portability changes (same api)
Suggested next version: 1.0.2
PVP next version:       1.0.1.1

Notes: requires .cabal changes to build with older base versions

==========
HGL

HEAD repo: http://darcs.haskell.org/packages/HGL
Released version:       3.1.1 (in ghc-6.6.1 extralibs tarball)
Current version:        3.1.1
Changes since:          build system changes
Suggested next version: 3.1.2
PVP next version:       3.1.1.1

Notes: requires .cabal changes to build with older base versions

==========
html

HEAD repo: http://darcs.haskell.org/packages/html
Released version:       1.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          build system changes
Suggested next version: 1.0.2
PVP next version:       1.0.1.1

==========
HUnit

HEAD repo: http://darcs.haskell.org/packages/HUnit
Released version:       1.1.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.1.1
Changes since:          some code changes, not obvious if api changed
Suggested next version: 1.1.2
PVP next version:       1.1.2

==========
mtl

HEAD repo: http://darcs.haskell.org/packages/mtl
Released version:       1.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          added more module re-exports and docs
Suggested next version: 1.0.2
PVP next version:       1.0.2

Note: does not build with ghc-6.4.x as base-1.0

==========
network

HEAD repo: http://darcs.haskell.org/packages/network
Released version:       2.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        2.0.1
Changes since:          IPV6 support added, api extended not changed
Suggested next version: 2.0.2
PVP next version:       2.0.2

Note: needs a patch to build with ghc-6.4.x and base-1.0

==========
ObjectIO

HEAD repo: http://darcs.haskell.org/packages/ObjectIO
Released version:       1.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          Setup.hs changes only
Suggested next version: 1.0.2
PVP next version:       1.0.1.1

==========
OpenAL

HEAD repo: http://darcs.haskell.org/packages/OpenAL
Released version:       1.3.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.3.1 
Changes since:          build system changes
Suggested next version: 1.3.2
PVP next version:       1.3.1.1

==========
OpenGL

HEAD repo: http://darcs.haskell.org/packages/OpenGL
Released version:       2.2.1 (in ghc-6.6.1 extralibs tarball)
Current version:        2.2.1
Changes since:          build system changes
Suggested next version: 2.2.2
PVP next version:       2.2.1.1

==========
parallel

HEAD repo: http://darcs.haskell.org/packages/parallel
Released version:       none
Current version:        1.0
Changes since:          n/a
Suggested next version: 1.0
PVP next version:       1.0

Note: cannot build with older ghc/base versions as it exposes modules
provided by base-2.x.

==========
parsec

HEAD repo: http://darcs.haskell.org/packages/parsec
Released version:       2.0 (hackage and ghc-6.6.1 extralibs tarball)
Current version:        2.0
Changes since:          api additions (extended, not changed)
Suggested next version: 2.0.1
PVP next version:       2.0.1

==========
QuickCheck

HEAD repo: http://darcs.haskell.org/QuickCheck
1.x  repo: http://darcs.haskell.org/packages/QuickCheck
Released version:       1.0.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          build system
Suggested next version: 1.0.2
PVP next version:       1.0.1.1

Note: we seem to be including QuickCheck 1.x rather than 2.x.

==========
regex-base

HEAD repo: http://darcs.haskell.org/packages/regex-unstable/regex-base
0.72 repo: http://darcs.haskell.org/packages/regex-base
Released version:       0.72 (in ghc-6.6.1 extralibs tarball)
                        0.92 (on hackage)
Current version:        0.72 (in ghc-6.8 extralibs) 
                        0.92 (upstream)
Changes since:          build system changes
Suggested next version: 0.72.1
PVP next version:       0.72.0.1

Note: we seem to be including regex-base 0.72 when the latest upstream
version is 0.92.

==========
regex-compat

HEAD repo: http://darcs.haskell.org/packages/regex-unstable/regex-compat
0.71 repo: http://darcs.haskell.org/packages/regex-compat
Released version:       0.71 (hackage and ghc-6.6.1 extralibs tarball)
                        0.90 (on hackage)
Current version:        0.71 (in ghc-6.8 extralibs)
                        0.90 (upstream)
Changes since:          trivial code change and build system changes
Suggested next version: 0.71.1
PVP next version:       0.71.0.1

Note: Setup.lhs needs fixing to be trivial. Again, we seem to be
including regex-base 0.71 when the latest upstream version is 0.90.

==========
regex-posix

HEAD repo: http://darcs.haskell.org/packages/regex-unstable/regex-posix
0.72 repo: http://darcs.haskell.org/packages/regex-posix
Released version:       0.71 (hackage and ghc-6.6.1 extralibs tarball)
                        0.91 (on hackage)
Current version:        0.72 (in ghc-6.8 extralibs)
                        0.91 (upstream)
Changes since:          compatible code changes and build system changes
Suggested next version: 0.72.1
PVP next version:       0.72.0.1

Note: will need patching to build with base-2.0. Again, we seem to be
including regex-base 0.72 when the latest upstream version is 0.91.

==========
stm

HEAD repo: http://darcs.haskell.org/packages/stm
Released version:       2.1 (hackage and ghc-6.6.1 extralibs tarball)
Current version:        2.1
Changes since:          two new new functions and build system changes
Suggested next version: 2.1.1
PVP next version:       2.1.1

Note: will not currently build with base-2.0. It's not clear if this is
a problem, or if stm is tightly tied to the base/ghc version anyway.

==========
time

HEAD repo: http://darcs.haskell.org/packages/time
Released version:       1.1.1 (in ghc-6.6.1 extralibs tarball)
Current version:        1.1.1
Changes since:          minor behaviour changes (bug fixes)
Suggested next version: 1.1.2
PVP next version:       1.1.2

==========
X11

HEAD repo: http://darcs.haskell.org/packages/X11
Released version:       1.2.3 (on hackage)
Current version:        1.2.3
Changes since:          none
Suggested next version: not needed
PVP next version:       not needed

==========
xhtml

HEAD repo: http://darcs.haskell.org/packages/xhtml
Released version:       3000.0.2 (in ghc-6.6.1 extralibs tarball)
Current version:        3000.0.2
Changes since:          minor build system changes
Suggested next version: 3000.0.3
PVP next version:       3000.0.2.1


Additionally, there are some core libs that could be usable with older
versions of other libs, like base and so could be used with older
releases of ghc or other implementations:
bytestring
Cabal
filepath
haskell98
readline
unix
Win32

==========
bytestring

HEAD repo: http://darcs.haskell.org/bytestring
Released version:       0.9 (on hackage)
Current version:        0.9
Changes since:          none
Suggested next version: not needed
PVP next version:       not needed

==========
Cabal

HEAD repo: http://darcs.haskell.org/cabal
Released version:       1.2.1 (on hackage)
Current version:        1.2.1
Changes since:          some minor changes
Suggested next version: 1.2.2
PVP next version:       1.2.2

==========
filepath

HEAD repo: http://darcs.haskell.org/packages/filepath
1.1  repo: http://darcs.haskell.org/ghc-6.8/packages/filepath
Released version:       1.0 (on hackage)
Current version:        1.1
Changes since:          api additions, bug fixes
Suggested next version: 1.1
PVP next version:       1.0.1

Note: filepath head branch is marked as version 1.0 while the version
included with ghc-6.8 is marked as 1.1.

==========
haskell98

HEAD repo: http://darcs.haskell.org/packages/haskell98
Released version:       1.0 (hackage and ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          build system changes
Suggested next version: ???
PVP next version:       1.0.0.1

Note: If the version number identifies the api to some degree, then the
H98 api never changes so it's version number should never increment,
except in the micro revision for build system changes.

==========
readline

HEAD repo: http://darcs.haskell.org/packages/readline
Released version:       1.0 (ghc-6.6.1 extralibs tarball)
Current version:        1.0.1
Changes since:          api additions, build system changes
Suggested next version: 1.0.1
PVP next version:       1.0.1

==========
unix

HEAD repo: http://darcs.haskell.org/packages/unix
Released version:       2.1 (ghc-6.6.1 extralibs tarball)
Current version:        2.2
Changes since:          many api additions
Suggested next version: 2.2
PVP next version:       2.1.1

Note: will not currently build with base-2.0.

==========
Win32

HEAD repo: http://darcs.haskell.org/packages/Win32
Released version:       2.1 (hackage and ghc-6.6.1 extralibs tarball)
Current version:        2.1.1
Changes since:          api additions
Suggested next version: 2.1.1
PVP next version:       2.1.1

Note: will not currently build with base-2.0.



Duncan


More information about the Libraries mailing list