Re: [Docaml-devel] Some notes

[Didier Le B. <did...@me...>]

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?