From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail2-relais-roc.national.inria.fr (mail2-relais-roc.national.inria.fr [192.134.164.83]) by yquem.inria.fr (Postfix) with ESMTP id DA5D5BBAF for ; Fri, 22 Jan 2010 09:43:56 +0100 (CET) X-IronPort-AV: E=Sophos;i="4.49,323,1262559600"; d="scan'208";a="41962706" Received: from arvin.irisa.fr (HELO [131.254.11.86]) ([131.254.11.86]) by mail2-relais-roc.national.inria.fr with ESMTP/TLS/DHE-RSA-AES256-SHA; 22 Jan 2010 09:43:56 +0100 Message-ID: <4B596486.90103@irisa.fr> Date: Fri, 22 Jan 2010 09:40:38 +0100 From: Tiphaine Turpin User-Agent: Thunderbird 2.0.0.19 (X11/20090216) MIME-Version: 1.0 To: Edgar Friendly Cc: caml-list@yquem.inria.fr Subject: Re: [Caml-list] Batteries Included 1.0.0 References: <4B51DC6B.6010903@gmail.com> In-Reply-To: <4B51DC6B.6010903@gmail.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit X-Spam: no; 0.00; irisa:01 dependencies:01 ocaml:01 syntax:01 enum:01 bug:01 -thread:01 ocamlfind:01 makefile:01 bug:01 howto:01 camomile:01 findlib:01 syntax:01 ocamldoc:01 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 >