Brad,

I'm currently working on the integration of your patch against latest
trunk revision. 

On Thu, 2007-09-27 at 15:59 +1000, Brad Hards wrote:
> 2. Modified scripts/mkproto.pl so that the comments are also put into the 
> header. This is the most hairy part, because I don't grok perl at all. I used 
> the samba4 script as a model - thanks to Jelmer for the suggestion.

Have seen the modification. Will give it a closer look.

> 3. Added the examples from the linuxconf.eu paper.
> 4. Added some content for the "main page" (start page). Mostly from the intro 
> to the linuxconf.eu paper.
> 5. Added an example of additional content. This page (on MAPI concepts) is 
> only to show what is possible. Again, content is from the linuxconf.eu paper. 
> I'd like to extract more from that paper, including the diagrams.

Thanks for the examples! This will be really useful when we add
additional documentation such as examples, FAQs or code samples in
further releases.

> There are still some parts that aren't as good as I'd like:
> - the man3 version is pig-ugly

I agree ;-) Will take time to see how we can improve this.

> - the documentation shows <libmapi/proto.h>, and there should be some 
> explanation that the right header is <libmapi.h>. That might be quite hard to 
> fix.

Fixed: using INPUT_FILTERS and sed in Doxyfile. Have also removed
_PUBLIC_ from the generated documentation.

> - there are too many undocumented functions/data structures/enums. I need to 
> suppress some of it, and fix the rest.

I've almost finished with libmapi-0.6 development. Conclusion: I can
take a couple of days to work on the documentation until we release the
new version.

-- 
Julien Kerihuel
[EMAIL PROTECTED]
OpenChange Project Manager

GPG Fingerprint: 0B55 783D A781 6329 108A  B609 7EF6 FE11 A35F 1F79

Attachment: signature.asc
Description: This is a digitally signed message part

_______________________________________________
devel mailing list
[email protected]
http://mailman.openchange.org/listinfo/devel

Reply via email to