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