On Mon, 3 Mar 2014 04:32:44 -0800, Anil Madhavapeddy wrote:
> 
> In packages/tuntap/tuntap.1.0.0/descr:
> 
> > @@ -0,0 +1,14 @@
> > +TUN/TAP bindings
> > +
> > +This is an OCaml library for handling TUN/TAP devices.  TUN refers to layer 3
> > +virtual interfaces whereas TAP refers to layer 2 Ethernet ones.
> > +
> > +See <http://en.wikipedia.org/wiki/TUN/TAP> for more information.
> > +
> > +Linux, FreeBSD, OpenBSD and MacOS X should all be supported.  You will need
> > +to install the third-party <http://tuntaposx.sourceforge.net/> on OSX before
> > +using this library.
> > +
> > +WWW:    <https://github.com/mirage/ocaml-tuntap>
> 
> The biggest problem here (which is why I'm not very good about
> keeping _oasis updated in general) is that baking the metadata into
> the archive leads to all sorts of duplication. 

That's why I wrote oasis2opam in the first place.  Keep the metadata
in _oasis (it matters because it directly influences your build
system) and generate the other files from that.

> [...] Similarly, the README has to contain this information, which
> then has to be duplicated into _oasis, which then has to be
> duplicated into OPAM :-/

The README (or part of it) can be generated from _oasis.  A plugin
generating a README.md file (with oasis "delimiters" in comments)
would be nice though.