Browse thread
Batteries Included 1.0.0
[
Home
]
[ Index:
by date
|
by threads
]
[ Message by date: previous | next ] [ Message in thread: previous | next ] [ Thread: previous | next ]
[ 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 >