Menu
▾
▴
docaml-devel — send patches and discuss them here
You can subscribe to this list here.
| 2004 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
(10) |
Aug
|
Sep
(3) |
Oct
|
Nov
|
Dec
|
|---|
|
From: Didier Le B. <did...@me...> - 2004-09-06 08:43:46
|
Andrei Formiga wrote: > As it's somewhat complicated to mess with the current sources and > compile them to see the result, wouldn't it be better if we could have > an wiki for documenting the OCaml system ? Then, as the content gets > mature, it can be rendered in other formats. There's even an OCaml > wiki now, we'd need only a host (or we could try a php wiki and go > with sourceforge). > > What do you think ? If it really eases contributing to it, it may be a good idea. However, one of the advantages of LaTeX is that you immediately get different formats such as pdf and html (with hevea). If we go for the wiki, should we let almost anybody modify the content (with a quick human check to avoid garbage) ? Do you know how to setup all this ? In short, I approve the wiki. -- Didier |
|
From: Alan S. <ala...@po...> - 2004-09-06 07:37:24
|
* Andrei Formiga (and...@gm...) wrote: > As it's somewhat complicated to mess with the current sources and > compile them to see the result, wouldn't it be better if we could have > an wiki for documenting the OCaml system ? Then, as the content gets > mature, it can be rendered in other formats. There's even an OCaml > wiki now, we'd need only a host (or we could try a php wiki and go > with sourceforge). >=20 > What do you think ? This is a great idea, and I'm 100 % for it. Unless it makes things too=20 complex, we should definitely try to use the ocaml wiki=20 (http://sandbox.merjis.com/). I might also be able to find a box to use=20 as a server at INRIA (we have an Apache 2.0 running, I'd need to install=20 the rest of the software ... this is on a Fedora Core 2, which I do not=20 know at all though). I'm going to try to investigate this, see if I can get it installed. =20 I'll let you know. Thanks for suggesting this. Alan Schmitt --=20 The hacker: someone who figured things out and made something cool happen. =2EO. =2E.O OOO |
|
From: Andrei F. <and...@gm...> - 2004-09-06 01:11:46
|
As it's somewhat complicated to mess with the current sources and compile them to see the result, wouldn't it be better if we could have an wiki for documenting the OCaml system ? Then, as the content gets mature, it can be rendered in other formats. There's even an OCaml wiki now, we'd need only a host (or we could try a php wiki and go with sourceforge). What do you think ? -- []s, Andrei de A. Formiga |
|
From: Didier Le B. <did...@me...> - 2004-07-08 07:04:13
|
Andrei Formiga wrote: > I've collected some raw notes here: > http://ktulu.freezope.org/artigos/ocaml/ > > Mostly things extracted from souce comments with very few comments of mine. > > What I intend to add to chapter 2, for now, is a list of the macros > and types from mlvalues.h and a description of each source file of the > runtime system (both are found in my notes, although rough and > unpolished). Should this be added to the end of the chapter, or to > another chapter altogether as reference, or what ? Personally, I like > to have an overall view first and then come down to more specific > stuff. But I haven't thought very much about organizing and > integrating this, so suggestions are welcome. > > Also, if someone reads the notes and want to send > corrections/suggestions/etc, it would help :) > There is already a three-line array with the description of the files. I suggest that we move this array at the end of the chapter (may be to a new section or subsection), and your descriptions of each source file would perfectly fit there. Do you agree? As for the macros, I would put them in a subsection 2.4.2. Again, this is only a suggestion. By the way, you feel comfortable using LaTeX, don't you? |
|
From: Andrei F. <and...@gm...> - 2004-07-07 20:35:04
|
I've collected some raw notes here: http://ktulu.freezope.org/artigos/ocaml/ Mostly things extracted from souce comments with very few comments of mine. What I intend to add to chapter 2, for now, is a list of the macros and types from mlvalues.h and a description of each source file of the runtime system (both are found in my notes, although rough and unpolished). Should this be added to the end of the chapter, or to another chapter altogether as reference, or what ? Personally, I like to have an overall view first and then come down to more specific stuff. But I haven't thought very much about organizing and integrating this, so suggestions are welcome. Also, if someone reads the notes and want to send corrections/suggestions/etc, it would help :) -- []s, Andrei de A. Formiga |
|
From: Alan S. <ala...@po...> - 2004-07-07 05:27:47
|
* Andrei Formiga (and...@gm...) wrote: >=20 > When I have something to contribute, it may be practical to have > write access to cvs. For now, I just hope my (little) free time > doesn't magically disappear. I see. Just let me know. >=20 > Regarding the current documentation, is there any plan or outline > for how it should be ? Well, as I was saying earlier, nothing has been done for 3 years, so if=20 there was a plan, it has since long been forgotten. I guess that, for the moment, we don't necessarily want to be too=20 structured: if there is something that you know about the internals that=20 is not there yet, add it somewhere (maybe in a new section at the end),=20 and we'll figure later where we want to put it in the whole document. =20 And don't worry about writing in English only, we'll fill in the French=20 translation later. I'll have some more time for this project after the Popl deadline, which=20 is July 16th. But I'll keep reading/answering emails until then. Alan Schmitt --=20 The hacker: someone who figured things out and made something cool happen. =2EO. =2E.O OOO |
|
From: Didier Le B. <did...@me...> - 2004-07-06 16:37:36
|
mardi 6 jui 2004 (11h35), Andrei Formiga a =E9crit : > When I have something to contribute, it may be practical to have > write access to cvs. For now, I just hope my (little) free time > doesn't magically disappear. My own time has magically disappeared. The reason for this weights 12kg and is 1.5 year old. > Regarding the current documentation, is there any plan or outline > for how it should be ? No. We used to maintain a french version and an english version. Feel free to write your comments in english, I'll be glad to translate them to french as soon as I have some time to do it. |
|
From: Andrei F. <and...@gm...> - 2004-07-06 14:35:20
|
On Tue, 6 Jul 2004 16:04:25 +0200, Alan Schmitt <ala...@po...> wrote: > > Great. If you want to become a developer for this project (to have cvs > write access), just tell me and I'll add you. When I have something to contribute, it may be practical to have write access to cvs. For now, I just hope my (little) free time doesn't magically disappear. Regarding the current documentation, is there any plan or outline for how it should be ? -- []s, Andrei de A. Formiga |
|
From: Alan S. <ala...@po...> - 2004-07-06 14:04:29
|
* Andrei Formiga (and...@gm...) wrote: >=20 > I have begun reading the ocaml sources and taking notes, then I > found this project (someone pointed it to me on the caml-list). I was > thinking about organizing these notes (in the future) so that maybe > someone else could learn something from them. So I am willing to > collaborate and send patches and all that to leverage what's already > done, instead of starting over. That's it. Great. If you want to become a developer for this project (to have cvs=20 write access), just tell me and I'll add you. Alan Schmitt --=20 The hacker: someone who figured things out and made something cool happen. =2EO. =2E.O OOO |
|
From: Andrei F. <and...@gm...> - 2004-07-06 12:38:27
|
On Tue, 6 Jul 2004 07:45:22 +0200, Didier Le Botlan <did...@me...> wrote: > > Yes. > Help me I am a prisoner. Don't talk to others. Don't trust what the other > say. > > I need a blue page. Bring me a blue page. Not the red pages. A blue > page. Thank you. I spent sufficient hours playing Myst to know that I shoudn't get your blue pages... Or were they the red ones that I shoudn't get ? It's been so long, I don't remember which is which :) > -- > OK, I'm kidding. Do you have any question concerning docaml ? > I have begun reading the ocaml sources and taking notes, then I found this project (someone pointed it to me on the caml-list). I was thinking about organizing these notes (in the future) so that maybe someone else could learn something from them. So I am willing to collaborate and send patches and all that to leverage what's already done, instead of starting over. That's it. -- []s, Andrei de A. Formiga |
|
From: Alan S. <ala...@po...> - 2004-07-06 06:37:53
|
* Andrei Formiga (and...@gm...) wrote: > Somebody here ? Hello. I have just checked that the code still builds, and it does. So if you=20 want to check out the files in CVS, don't hesitate to do so. Alan Schmitt --=20 The hacker: someone who figured things out and made something cool happen. =2EO. =2E.O OOO |
|
From: Didier Le B. <did...@me...> - 2004-07-06 05:49:29
|
mardi 6 jui 2004 ( 0h37), Andrei Formiga a =E9crit : > Somebody here ? Yes. Help me I am a prisoner. Don't talk to others. Don't trust what the other say. I need a blue page. Bring me a blue page. Not the red pages. A blue page. Thank you. -- OK, I'm kidding. Do you have any question concerning docaml ? |
|
From: Andrei F. <and...@gm...> - 2004-07-06 03:37:22
|
Somebody here ? -- []s, Andrei de A. Formiga |
