2013_11_08_opam_1.1.0_released.md 3.25 KB
Newer Older
Raja Boujbel's avatar
Raja Boujbel committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33
title=OPAM 1.1.0 released
authors=Thomas Gazagnaire

After a while staged as RC, we are proud to announce the final release of
*OPAM 1.1.0*!

Thanks again to those who have helped testing and fixing the last few issues.

## Important note ##

The repository format has been improved with incompatible new features; to
account for this, the *new* repository is now hosted at [opam.ocaml.org][],
and the legacy repository at [opam.ocamlpro.com][] is kept to support OPAM
1.0 installations, but is unlikely to benefit from many package updates.
Migration to [opam.ocaml.org][] will be done automatically as soon as you
upgrade your OPAM version.

You're still free, of course, to use any third-party repositories instead or
in addition.

## Installing ##

NOTE: When switching from 1.0, the internal state will need to be upgraded.
THIS PROCESS CANNOT BE REVERTED. We have tried hard to make it fault-
resistant, but failures might happen. In case you have precious data in your 
`~/.opam` folder, it is advised to **backup that folder before you upgrade
to 1.1.0**.

Using the binary installer:
- download and run `https://github.com/ocaml/opam/blob/master/shell/opam_installer.sh` 
Raja Boujbel's avatar
Raja Boujbel committed
35 36 37 38 39 40 41 42 43

Using the .deb packages from Anil's PPA (binaries are [currently syncing][1]):
   add-apt-repository ppa:avsm/ppa
   apt-get update
   sudo apt-get install opam

For OSX users, the homebrew package will be updated shortly.

or build it from sources at :
- `https://github.com/ocaml/opam/releases/tag/1.1.0`
Raja Boujbel's avatar
Raja Boujbel committed
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79

## For those who haven't been paying attention ##

OPAM is a source-based package manager for OCaml. It supports multiple
simultaneous compiler installations, flexible package constraints, and
a Git-friendly development workflow. OPAM is edited and
maintained by OCamlPro, with continuous support from OCamlLabs and the
community at large (including its main industrial users such as
Jane-Street and Citrix).

The 'official' package repository is now hosted at [opam.ocaml.org][],
synchronised with the Git repository at
[http://github.com/ocaml/opam-repository][repo], where you can contribute
new packages descriptions. Those are under a CC0 license, a.k.a. public
domain, to ensure they will always belong to the community.

Thanks to all of you who have helped build this repository and made OPAM
such a success.

## Changes ##

Too many to list here, see

For packagers, some new fields have appeared in the OPAM description format:
- `depexts` provides facilities for dealing with system (non ocaml) dependencies
- `messages`, `post-messages` can be used to notify the user eg. of licensing information,
 or help her  troobleshoot at package installation.
- `available` supersedes `ocaml-version` and `os` constraints, and can contain
 more expressive formulas

Also, we have integrated the main package repository with Travis, which will
help us to improve the quality of contributions (see [Anil's post][2]).

[opam.ocaml.org]: https://opam.ocaml.org
80 81
[opam.ocamlpro.com]: https://opam.ocamlpro.com
[repo]: https://github.com/ocaml/opam-repository
Raja Boujbel's avatar
Raja Boujbel committed
[1]: https://launchpad.net/~avsm/+archive/ppa/+builds?build_state=pending
83 84
[2]: https://anil.recoil.org/2013/09/30/travis-and-ocaml.html