Version française
Home     About     Download     Resources     Contact us    
Browse thread
Batteries Included 1.0.0
[ Home ] [ Index: by date | by threads ]
[ Search: ]

[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
Date: -- (:)
From: Tiphaine Turpin <Tiphaine.Turpin@i...>
Subject: Re: [Caml-list] Batteries Included 1.0.0
Thank you for your work on batteries. Here are a few comments that I
have, having "migrated" my source code to this new version.

First, I appreciate the reduction of dependencies. This makes it much
more reasonable to share code using batteries.

On the negative side, my greatest concern is about outdated
documentation : I found it very difficult to know what had changed, and
how to adapt my code. These changes range from the deletion of some
features (batteries/ocaml* tools,  myocamlbuild.ml, "open in" syntax
extension, implicit "open Batteries") to minor API changes (naming of
Standard, Data, Shell modules, no more Different_list_size exception, no
more Queue.enum...). Also, there seems to be a packaging bug which
requires using -thread in the ocamlfind command.

So, I spent a significant time replacing my old 1-line ocamlbuild
command by a real Makefile (also because of a strange and probably
unrelated linking bug which I still don't fully understand). I believe
that an updated compiling howto is really needed, as well as a list of
the main deleted features with respect to the last release, allowing
users to estimate how much change their code will need.

Other than that, I have not found any regression or other problems in
this new release of the library, and I'm looking forward to see its
further development.

Tiphaine


Edgar Friendly a écrit :
> The Batteries Included project has come under new management since
> David Teller moved on. The project has gone through a process of
> reorganization and is finally ready for a release. We've rethought a
> lot of the structure decisions of the old codebase to make it easier
> to use and develop.
>
> Major changes:
> * Builds in 10 seconds, plus 10 seconds for documentation (on my system)
> * Depends only on Camomile and Findlib
> * Syntax Extensions now optional
> * Less magic in build system
> * Allows smaller executable creation
>
> We're using OMake instead of ocamlbuild and a much more stock ocamldoc
> for documentation generation. All the modules we provide are standard
> modules, no [module Array = struct include Array ... end] magic except
> in batteries.ml which ties everything together for convenience. Of
> course there's a bunch of bug fixes and additional functions.
>
> We're using Semantic Versioning (http://semver.org/) for version
> numbers, meaning we're taking backwards compatibility very seriously.
> This is our 1.0.0 release, but we don't expect to stay at it very
> long. We're looking forward to fixing any bugs you find.
>
> To use:
> Download:
> https://forge.ocamlcore.org/frs/download.php/346/batteries-1.0.0.tar.gz
> Documentation: http://thelema.github.com/batteries-included/hdoc
>
> To contribute:
> Mailing list:
> https://lists.forge.ocamlcore.org/cgi-bin/listinfo/batteries-devel
> Issue Tracker: http://github.com/thelema/batteries-included/issues
> Code: git://github.com/thelema/batteries-included.git
>
>
> [1] Like the small batteries used in TV remote controls
>
> _______________________________________________
> Caml-list mailing list. Subscription management:
> http://yquem.inria.fr/cgi-bin/mailman/listinfo/caml-list
> Archives: http://caml.inria.fr
> Beginner's list: http://groups.yahoo.com/group/ocaml_beginners
> Bug reports: http://caml.inria.fr/bin/caml-bugs
>