ObjectMerging Documentation

[Christopher Armstrong-5]

Hi all

I've added the start of a "Developer's Guide" in trunk/Developer/DeveloperGuide. It documents the basics of ObjectMerging.

There is a sample used in the documentation in trunk/Frameworks/ObjectMerging/Samples/BasicPersistence.

The intention is to turn the manual into a general developer manual for Etoile. I've written it in texinfo, but I will probably convert it over to pure LaTeX soon.

I also think we should discuss making some kind of "developer preview" or "alpha" release of some Etoile frameworks soon to get things into people's hands to play with and test.

Regards
Chris

--------
Christopher Armstrong
carmstrong@...






_______________________________________________
Etoile-dev mailing list
Etoile-dev@...
https://mail.gna.org/listinfo/etoile-dev

[David Chisnall]

On 9 Oct 2011, at 13:01, Christopher Armstrong wrote:

> Hi all
>
> I've added the start of a "Developer's Guide" in trunk/Developer/DeveloperGuide. It documents the basics of ObjectMerging.
>
> There is a sample used in the documentation in trunk/Frameworks/ObjectMerging/Samples/BasicPersistence.
>
> The intention is to turn the manual into a general developer manual for Etoile. I've written it in texinfo, but I will probably convert it over to pure LaTeX soon.

That's really great!  I hope to contribute some text to it soon...

> I also think we should discuss making some kind of "developer preview" or "alpha" release of some Etoile frameworks soon to get things into people's hands to play with and test.

LanguageKit is more or less ready for release.  The next version will be classed as a preview release for x86-64, but fully supported on x86.  Niels was working on adding x86-64 calling convention support, but there's now talk in LLVM of adding that kind of thing in a generic way that all front ends can use, which would simplify LanguageKit's life a lot.  

I think EtoileFondation is close to ready to release.  I'm tempted to rewrite the NSObject+Prototypes stuff one more time.  I've just added a function to libobjc2 that Apple introduced with iOS 4.3 / OS X 10.7, which allows you to convert a block into an IMP.  This would make using blocks as methods in prototypes trivial, and now works on OS X too.  

David

-- Sent from my brain


_______________________________________________
Etoile-dev mailing list
Etoile-dev@...
https://mail.gna.org/listinfo/etoile-dev

[Quentin Mathé-2]

Hi Christopher,

Le 9 oct. 2011 à 14:01, Christopher Armstrong a écrit :

> Hi all
>
> I've added the start of a "Developer's Guide" in trunk/Developer/DeveloperGuide. It documents the basics of ObjectMerging.
>
> There is a sample used in the documentation in trunk/Frameworks/ObjectMerging/Samples/BasicPersistence.
>
> The intention is to turn the manual into a general developer manual for Etoile. I've written it in texinfo, but I will probably convert it over to pure LaTeX soon.

Both the example and the guide looks great. They explain all the basic things you need to know quickly and very clearly.
The only issue I see is that the commit track section is hard to understand if you haven't read the mails you wrote about it.

I think the Developer doc should be moved to Developer/Documentation. The generated API doc is located here and there is already a Guides directory which contains the EtoileUI Quick Start Guide.
We should just keep the User related doc in the root Documentation directory. We could put a symbolic link to Developer/Documentation in Documentation.

Cheers,
Quentin.
_______________________________________________
Etoile-dev mailing list
Etoile-dev@...
https://mail.gna.org/listinfo/etoile-dev