From: Nicolas C. <war...@fr...> - 2003-06-19 05:46:46
|
Modules that will be included in 1.0 : (extensions to ocaml stdlib) - ExtArray : missing implementation and incomplete documentation - ExtHashtbl : missing implementation and incomplete documentation - ExtList : missing documentation - ExtString : incomplete documentation - Std : missing documentation (new modules) - DynArray : should be OK - Enum : missing documentation - Global : should be OK - Option : should be OK - Psqueue : still have bug ? should be OK - RefList : missing little documentation (if ready before release) - Unicode by Yamagata Yoriyuki - BinTree (mutable Set) by Diego Olivier Fernandez Pons The 1.0 will be freely shipped for all ocaml people in the world :-) Will be released as a source TGZ or ZIP. For compilation, I think it's a good idea to include ocamake.ml and then have a script/Makefile that first compile ocamake and then run it. Windows precompiled binaries will be also available. Time to relase : few weeks. If people are interested in code/documentation review, please browse the CVS at Sourceforge ( http://sourceforge.net/projects/ocaml-lib ) and report any bug/problem on this mailling list. Nicolas Cannasse |
From: Nicolas C. <war...@fr...> - 2003-07-01 10:16:29
|
On the way to 1.0 : I did some documentation review, correction for the following modules : - Global - Std - RefList - DynArray - Enum - Option and we can consider theses as "ready for release", although I would be happy if someone reviewed my review. The following modules are still missing implementation : - ExtArray ( should be add this one since DynArray is somehow better ? ) - ExtHashtbl The following modules are needing documentation : - ExtList - ExtString - UChar - UTF8 - Bitset (not commited yet) What about current state of PSQueue ? bug fixed or not ? Nicolas Cannasse |
From: Yamagata Y. <yor...@mb...> - 2003-07-02 03:21:06
|
From: "Nicolas Cannasse" <war...@fr...> Subject: [Ocaml-lib-devel] Way to 1.0 Date: Tue, 1 Jul 2003 19:02:31 +0900 > The following modules are needing documentation : .. snip .. > - UChar > - UTF8 All functions are now ducumented, and I have corrected typos etc. -- Yamagata Yoriyuki |
From: Nicolas C. <war...@fr...> - 2003-07-02 10:11:45
|
> > The following modules are needing documentation : > .. snip .. > > - UChar > > - UTF8 > > All functions are now ducumented, and I have corrected typos etc. > Your documentation is not compatible with Ocamldoc, please watch the other documented modules and switch to ocamldoc format. Please also add the LGPL header at the beginning of both ML and MLI files with a (c) from you. Thanks, Nicolas Cannasse |
From: Yamagata Y. <yor...@mb...> - 2003-07-03 16:45:56
|
From: "Nicolas Cannasse" <war...@fr...> Subject: Re: [Ocaml-lib-devel] Way to 1.0 Date: Wed, 2 Jul 2003 17:39:38 +0900 > Your documentation is not compatible with Ocamldoc, please watch the other > documented modules and switch to ocamldoc format. Please also add the LGPL > header at the beginning of both ML and MLI files with a (c) from you. All done by now, I hope. Btw, Could we enable other document types other than html by, say, adding new targets in Makefile? I think I'm not alone in preferring Texinfo to HTML, for example. -- Yamagata Yoriyuki |
From: John M. S. <sk...@oz...> - 2003-07-03 10:22:24
|
Nicolas Cannasse wrote: > On the way to 1.0 : > > I did some documentation review, correction for the following modules : > - Global What's this for anyhow? Doesn't seem like we should be encouraging any use of global data. -- John Max Skaller, mailto:sk...@oz... snail:10/1 Toxteth Rd, Glebe, NSW 2037, Australia. voice:61-2-9660-0850 |
From: Nicolas C. <war...@fr...> - 2003-07-04 01:59:53
|
> > On the way to 1.0 : > > > > I did some documentation review, correction for the following modules : > > - Global > > > What's this for anyhow? Doesn't seem like we > should be encouraging any use of global data. Of course in OCaml you can always have some globals being locals. But for example, sometimes you have quite a deep-called function that actually needs one variable that is only known 5 or 6 functions up in the call stack. Adding an extra argument to all the intermediate functions even if they don't use it can be done once, perhaps twice but definitly not three times :-) Sometimes when you having something like this it's usefull to use something like globals . If you look at the sources of the ocaml compiler, there is a lot of such samples. Nicolas Cannasse |
From: John M. S. <sk...@oz...> - 2003-07-05 19:25:11
|
Nicolas Cannasse wrote: > Of course in OCaml you can always have some globals being locals. > But for example, sometimes you have quite a deep-called function that > actually needs one variable that is only known 5 or 6 functions up in the > call stack. Adding an extra argument to all the intermediate functions even > if they don't use it can be done once, perhaps twice but definitly not three > times :-) Sometimes when you having something like this it's usefull to use > something like globals . If you look at the sources of the ocaml compiler, > there is a lot of such samples. Globals are EVIL -- John Max Skaller, mailto:sk...@oz... snail:10/1 Toxteth Rd, Glebe, NSW 2037, Australia. voice:61-2-9660-0850 |