Difference between revisions of "Haskell Platform"

From HaskellWiki
Jump to navigation Jump to search
(Update gentoo status)
(add link to unofficial versions comparison chart)
(47 intermediate revisions by 12 users not shown)
Line 1: Line 1:
  +
{{HP}}
−
[[Image:Platform.png|300px]]
  
   
  +
The Haskell Platform is a single, standard [[Haskell]] development environment for everyone. It offers a set of blessed libraries and tools, to save you the task of picking and choosing which core Haskell libraries to use.
−
__NOTOC__
  
   
  +
[http://hackage.haskell.org/platform/contents.html Learn more about the Haskell Platform ⇒]
−
The Haskell Platform (HP) is the name of the blessed, core library suite for Haskell. By taking the best libraries from the more than 1200 libraries of [http://hackage.haskell.org Hackage], it provides a comprehensive, stable and mature base for Haskell projects to work from.
  
   
  +
__TOC__
−
See the [http://trac.haskell.org/haskell-platform/wiki Platform Issue Tracker] for further information.
  
   
−
== Status ==
 +
== What's in the platform ==
   
  +
See
−
The platform is specified via a Cabal file:
  
  +
* the [http://hackage.haskell.org/platform/changelog.html change log]
  +
* the unofficial [http://sol.github.com/haskell-platform-versions-comparison-chart/ Versions Comparison Chart]
   
  +
== Trouble shooting ==
−
* '''[http://code.haskell.org/haskell-platform/haskell-platform.cabal The Haskell Platform 2009.0.0] (alpha) '''
  
   
  +
The Haskell Platform project maintains a bug tracker and wiki site, which you can use to report problems, or request features:
−
The initial release targets:
  
   
  +
* [http://trac.haskell.org/haskell-platform/report/1 Known issues]
−
* ghc-6.10.2
  
−
* [http://trac.haskell.org/haskell-platform/wiki/Library/VersionMatrix#PlatformPackages Classic Extra Libs]
 +
* [http://trac.haskell.org/haskell-platform/newticket?summary=%3CProblem%3E&description=%3CDescribe%20the%20problem%3E&component=Platform Report a bug]
−
* haddock, happy and alex
  
−
* cabal-install and its dependencies.
  
   
−
== Distributions ==
 +
=== Developers ===
   
  +
For developers, there is a wiki page with project details:
−
Distros that support the Haskell Platform
  
   
  +
* [http://trac.haskell.org/haskell-platform/ Developer's wiki]
−
{|
  
  +
* [http://trac.haskell.org/haskell-platform/wiki/ReleaseTimetable Release Timetable]
−
|-
  
−
| '''System'''
  
−
| '''Status'''
  
−
|-
  
−
|Arch
  
−
| ''To be constructed with cabal2arch''
  
−
|-
  
−
|Debian
  
−
|
  
−
|-
  
−
|Fedora
  
−
|
  
−
|-
  
−
|Gentoo
  
−
| Available in the gentoo haskell overlay, large parts in portage
  
−
|-
  
−
|Ubuntu
  
−
|
  
−
|-
  
−
| Generic Unix Installer
  
−
|
  
−
|-
  
−
|
  
−
|
  
−
|-
  
−
|Windows Installer
  
−
|
  
−
|-
  
−
| OSX Installer
  
−
|
  
−
|-
  
−
|}
  
   
−
== Volunteers needed! ==
 +
== Buttons ==
   
  +
We have some buttons to let your friends know about the Haskell Platform.
−
We are calling for volunteers for an action group. We need volunteers to
  
−
take charge of various platforms and to manage the overall release.
  
−
We would like to release a beta at the upcoming [[Hac5|Haskell
  
−
Hackathon in Utrecht (April 17-19)]]. However this will '''only''' happen if people volunteer to help build distributions for different platforms.
  
   
  +
[http://hackage.haskell.org/platform http://hackage.haskell.org/platform/icons/button-100.png]
−
In particular we need:
  
−
* Release manager / coordinator
  
−
* Website with downloads and release notes
  
−
* Someone in charge of each platform:
  
−
** Windows installer
  
−
** OSX installer
  
−
** Generic Unix source tarball
  
−
** Distribution packages: debian, fedora, gentoo, arch, BSD* etc
  
   
  +
Use this html in your site:
−
The person in charge of each platform is responsible for building a appropriate native packages / installer and coordinating the effort to test that the stuff installs and works ok.
  
   
  +
<code>
−
If no one volunteers, we simply won't have an Haskell Platform release for that platform.
  
  +
<nowiki>
  +
<a href="http://hackage.haskell.org/platform"
  +
><img src="http://hackage.haskell.org/platform/icons/button-100.png"></a>
  +
</nowiki>
  +
</code>
   
  +
[http://hackage.haskell.org/platform http://hackage.haskell.org/platform/icons/button-64.png]
−
Please join the mailing list and volunteer!
  
   
  +
Use this html in your site:
−
== Resources ==
  
   
  +
<code>
−
* [http://trac.haskell.org/haskell-platform/ Issue tracker and dev wiki]
  
  +
<nowiki>
−
* [http://code.haskell.org/haskell-platform Darcs repository]: contains the meta-package and scripts for the generic unix tarball
  
  +
<a href="http://hackage.haskell.org/platform"
−
* [[/FAQ]]
  
−
* [http://projects.haskell.org/cgi-bin/mailman/listinfo/haskell-platform Mailing list]
 +
><img src="http://hackage.haskell.org/platform/icons/button-64.png"></a>
  +
</nowiki>
−
* IRC channel: #ghc @ freenode.org
  
  +
</code>
−
* [http://www.galois.com/blog/2009/03/23/one-million-haskell-downloads/ Download statistics for Haskell Packages]
  
   
  +
SVG source for the button: http://haskell.org/haskellwiki/Image:Button.svg
−
== Documentation ==
  
   
  +
=== Icons ===
−
* [http://cgi.cse.unsw.edu.au/~dons/blog/2008/07/29#batteries The Haskell Platform Proposal] for the 2008 Haskell Symposium
  
−
* [http://blog.well-typed.com/2008/11/haskell-platform-talk-at-the-london-haskell-users-group/ Slides from the Haskell Platform talk]
  
−
* [http://blog.well-typed.com/2008/09/hackage-hacking-and-demo/ Haskell Platform discussion]
  
−
* Bryan O'Sullivan's [http://www.serpentine.com/blog/2008/09/26/some-notes-on-the-future-of-haskell-and-fp/ writeup] of the future of Haskell discussion
  
−
* [http://thread.gmane.org/gmane.comp.lang.haskell.cvs.ghc/28062/focus=28807 A discussion] took place in June and July 2008 about the direction of the HLP.
  
−
* [http://haskell.org/~duncan/ghc/%23ghc-2008-07-16.log More occurred during the #ghc meeting]
  
   
  +
Icons for the platform installer and desktop.
−
===Quality Control===
  
   
  +
[http://ireneknapp.com/himitsu/Platform-100.png http://ireneknapp.com/himitsu/Platform-100.png]
−
Inclusion or exclusion in the platform will be driven by metrics, objective measurements we can extract from code. Determining appropriate metrics is a milestone.
  
   
  +
[http://ireneknapp.com/himitsu/Platform-64.png http://ireneknapp.com/himitsu/Platform-64.png]
−
* cabal-installable libraries with haddocks.
  
−
* packages should follow the [[Package versioning policy]]
  
−
* The set of HP packages + core libs must be closed. In other words, all haskell dependencies must be from within the HP packages or core libs. Dependencies on C libs can be external.
  
−
* All packages in a particular HP version must have a consistent install plan.
  
   
  +
=== Legal ===
−
That means only one version of each package and all dependencies on packages must be satisfied by the version in the HP package set.
  
   
  +
* The cherry blossom image used in the 2011 HP release is [http://www.flickr.com/photos/28481088@N00/3291086383/ licensed CC by tanakawho]
−
There is code in cabal-install to check the last two requirements.
  
−  
−
Other possible ideas for quality standards we might want to require:
  
−  
−
* Uses base library types, to force API standardisation
  
−
* exposed module names must follow the hierarchical module name convention, meaning they must be in an appropriate place in the module namespace. In particular, no clash of module names should occur within the HP.
  
−  
−
=== Other heuristics ===
  
−  
−
Packages set for inclusion should:
  
−  
−
* Have a maintainer
  
−
* Have a bug tracker
 
−
* Use the correct versioning
  
−
* Build with cabal
  
−
* Work on all arches.
  
−  
−
Further goals:
  
−  
−
* -Wall clean
  
−
* 100% coverage
  
−
* Have real world use.
  
−
* Answer a notable set of build dependencies.
  
−
* Have a declared correctness test suite.
  
−
* Have a declared performance test suite.
  
−
* BSD licensed
  
−  
−
== Distribution format ==
  
−  
−
* Source distribution
  
−
* .tar.gz bundle compatible with extra-libs
  
−
* Windows Installed
  
−
* Native distro packages
  
−  
−
The HP will be the first '''meta-package''' on hackage, that depends on the platform library set. With this,
  
−  
−
cabal install haskell-platform
  
−  
−
will be possible.
  
−  
−
== Version policy ==
  
−  
−
yyyy.major.minor,
  
−  
−
* odd major numbers indicate unstable branches
  
−
* minor numbers indicate bug fixes only, no API changes.
  
−  
−
Examples:
  
−  
−
* 2008.0.0 -- first biannual major stable release
  
−
* 2008.0.1 -- minor release, bug fix only
  
−
* 2008.1 -- unstable branch leading to next major release
  
−
* 2008.2.0 -- second annual major release, API changes
  
−
* 2008.2.1 -- bug fixes
  
−
* 2008.3 -- unstable branch of 2008
  
−
* 2009.0.0 -- first release in 2009.
  
−  
−
Additionally, if a library is accepted into the platform, it is suggested its version number be lifted to 1.0, if not already at 1.0.
  
−  
−
== Licenses ==
  
−  
−
The initial release is expected to include only BSD3 licensed software.
  
−  
−
== Programs ==
  
−  
−
The platform includes programs, such as haddock or cabal-install.
  
−
These aren't nicely tracked from the cabal meta package yet.
  
−  
−
== Build system ==
  
−  
−
Two ways to build the bundle:
  
−  
−
* generate a sh script from the .cabal file
  
−  
−
Or, build cabal-install, have the components of the platform
  
−
as a mini, local hackage archive, and then ask cabal install to satisfy
  
−
and install the dependencies from the platform meta-cabal file.
  
−  
−
== Related projects ==
  
−  
−
* [http://docs.python.org/lib/lib.html Python libraries]
  
−
* [http://live.gnome.org/ReleasePlanning Gnome's release process]
  
−
* [http://live.gnome.org/ReleasePlanning/ModuleProposing How to propose modules for GNOME]
  
−
* [http://forge.ocamlcore.org/projects/batteries/ OCaml Batteries]
  
−  
−
== Developers ==
  
−  
−
Haskell Platform core team:
  
−  
−
* Duncan Coutts (Well Typed)
  
−
* Don Stewart (Galois)
  
−  
−
[[Category:Community]]
  

Revision as of 09:44, 18 March 2012

Platform.png
The Haskell Platform


The Haskell Platform is a single, standard Haskell development environment for everyone. It offers a set of blessed libraries and tools, to save you the task of picking and choosing which core Haskell libraries to use.

Learn more about the Haskell Platform ⇒

What's in the platform

See

Trouble shooting

The Haskell Platform project maintains a bug tracker and wiki site, which you can use to report problems, or request features:

Developers

For developers, there is a wiki page with project details:

Buttons

We have some buttons to let your friends know about the Haskell Platform.

button-100.png

Use this html in your site:

<a href="http://hackage.haskell.org/platform" ><img src="http://hackage.haskell.org/platform/icons/button-100.png"></a>

button-64.png

Use this html in your site:

<a href="http://hackage.haskell.org/platform" ><img src="http://hackage.haskell.org/platform/icons/button-64.png"></a>

SVG source for the button: http://haskell.org/haskellwiki/Image:Button.svg

Icons

Icons for the platform installer and desktop.

Platform-100.png

Platform-64.png

Legal

Retrieved from "https://wiki.haskell.org/index.php?title=Haskell_Platform&oldid=44952"